Jekyll与Obsidian使用baseurl时的图片URL配置问题
解决Jekyll子目录部署与Obsidian图片预览兼容问题
以下是几个无需修改Markdown中格式的解决办法:
方法1:全局替换图片路径(最简单)
在Jekyll的通用布局模板(比如_layouts/default.html)中,对页面内容做批量路径替换,让Jekyll生成时自动给图片路径加上baseurl:
{{ content | replace: ' }}
Obsidian里的图片链接完全不受影响,Jekyll编译后会自动把路径修正为http://example.com/blog/media/image.jpg。
方法2:Obsidian路径设置配合Jekyll配置
- Obsidian端:打开「设置→文件与链接」,将「文件链接格式」设为「相对路径到库根目录」,确保所有图片链接默认是
media/image.jpg,保证预览正常。 - Jekyll端:在
_config.yml中添加include: ["media"],确保media文件夹被正确复制到部署目录。再用方法1的全局替换逻辑处理路径即可。
方法3:自定义Jekyll插件实现精准替换
如果需要更灵活的路径处理,可以写一个简单的Ruby插件:
- 在站点根目录创建
_plugins/image_path_filter.rb,内容如下:
module ImagePathFilter def fix_image_paths(content) # 匹配所有格式的链接,替换为带baseurl的路径 content.gsub(/!\[(.*?)\]\(media\/(.*?)\)/) do "" end end end Liquid::Template.register_filter(ImagePathFilter)
- 在布局模板中使用这个过滤器:
{{ content | fix_image_paths }}
这个插件会精准替换所有符合格式的图片链接,不影响其他内容,同时Obsidian预览完全正常。
内容的提问来源于stack exchange,提问作者user1421930
相关产品推荐
相关产品推荐

