You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Jekyll与Obsidian使用baseurl时的图片URL配置问题

解决Jekyll子目录部署与Obsidian图片预览兼容问题

以下是几个无需修改Markdown中![](media/image.jpg)格式的解决办法:

方法1:全局替换图片路径(最简单)

在Jekyll的通用布局模板(比如_layouts/default.html)中,对页面内容做批量路径替换,让Jekyll生成时自动给图片路径加上baseurl:

{{ content | replace: '![](media/', "![](#{site.baseurl}/media/") }}

Obsidian里的图片链接完全不受影响,Jekyll编译后会自动把路径修正为http://example.com/blog/media/image.jpg。

方法2:Obsidian路径设置配合Jekyll配置

  1. Obsidian端:打开「设置→文件与链接」,将「文件链接格式」设为「相对路径到库根目录」,确保所有图片链接默认是media/image.jpg,保证预览正常。
  2. Jekyll端:在_config.yml中添加include: ["media"],确保media文件夹被正确复制到部署目录。再用方法1的全局替换逻辑处理路径即可。

方法3:自定义Jekyll插件实现精准替换

如果需要更灵活的路径处理,可以写一个简单的Ruby插件:

  1. 在站点根目录创建_plugins/image_path_filter.rb,内容如下:
module ImagePathFilter
  def fix_image_paths(content)
    # 匹配所有![](media/xxx)格式的链接,替换为带baseurl的路径
    content.gsub(/!\[(.*?)\]\(media\/(.*?)\)/) do
      "![#{$1}](#{@context.registers[:site].baseurl}/media/#{$2})"
    end
  end
end

Liquid::Template.register_filter(ImagePathFilter)
  1. 在布局模板中使用这个过滤器:
{{ content | fix_image_paths }}

这个插件会精准替换所有符合格式的图片链接,不影响其他内容,同时Obsidian预览完全正常。


内容的提问来源于stack exchange,提问作者user1421930

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.11 04:12:41