obsidian使用技巧
Pandoc 插件导出 Word 格式 正确识别本地图片
插件ID：pandoc-%E6%8F%92%E4%BB%B6%E5%AF%BC%E5%87%BA-word-%E6%A0%BC%E5%BC%8F-%E6%AD%A3%E7%A1%AE%E8%AF%86%E5%88%AB%E6%9C%AC%E5%9C%B0%E5%9B%BE%E7%89%87
pandoc-%E6%8F%92%E4%BB%B6%E5%AF%BC%E5%87%BA-word-%E6%A0%BC%E5%BC%8F-%E6%AD%A3%E7%A1%AE%E8%AF%86%E5%88%AB%E6%9C%AC%E5%9C%B0%E5%9B%BE%E7%89%87
pandoc %E6%8F%92%E4%BB%B6%E5%AF%BC%E5%87%BA-word-%E6%A0%BC%E5%BC%8F-%E6%AD%A3%E7%A1%AE%E8%AF%86%E5%88%AB%E6%9C%AC%E5%9C%B0%E5%9B%BE%E7%89%87：
Pandoc 插件导出 Word 格式 正确识别本地图片
pandoc 插件可以把 OB 的 md 格式导出各种格式，比如 Office 格式。
当导出 docx 格式时，本地插入的图片有时无法正确显示，有时却可以正确导出并显示。下面通过一系列实验，找出规律并进行总结，给在这方面有困惑的人参考。
插件安装并配置
首先正确安装并设置 pandoc 插件，这点无需多说，只说重点几个点
- pandoc 需要下载客户端并安装，安装后在 ob 的 pandoc 插件中指定安装路径
如图，指定是 `C:\Program Files\Pandoc\pandoc.exe`
2 文档源格式是以 html 还是 markdown 格式导出，这里是能否正确显示图片的关键，下面会重点说
准备 md 文档 开始测试
- 图片格式如果是图床形式，比如 http 或者 https 开头测试均可正常导出并识别。
- 图片格式如果是本地图片。这里分两种情况
- wiki 格式的图片 格式为
![[XXXX.png]]这类的 需要 pandoc 中设置源格式 html 才可以正确识别。 - md 格式的图片 格式为
这种格式需要 pandoc 设置源格式为 markdown 才可以正确识别。
正确识别，不代表导出的 word 格式能正常显示图片，下面还有几个坑需要注意。
测试总结
为了表述问题更清楚，下面几个前提条件
- 测试图片名称为
202111241058704.png并位于库文件夹中的“附件”目录下 - Ob 库的物理路径为
E:\Obsidian文档库\
- 引用在线图床的图片，均正确导出。
- 引用图片如果是 file:/// 协议需要删除 file:/// 即可正确识别
- pandoc 插件设置文件源格式为html， 文档图片使用
![[XX]]的形式，基于库的相对路径插入的图片才能正确识别。比如[[附件/202111241058704.png]] - 当设置文件源格式markdown，文章引入图片的格式为
。默认 pandoc 只去库根目录查找图片，如果图片存在其他目录需要使用参数指定，比如添加参数--resource-path="E:\Obsidian文档库\附件\"mac 系统 应该是类似--resource-path=""/Users/xxx/Obsidian文档库/附件/"地址
- 当设置文件源格式markdown，文章引入图片的格式为
。默认 pandoc 只去库根目录查找图片，需要添加参数--resource-path="E:\Obsidian文档库\"mac 系统 应该是类似--resource-path=""/Users/xxx/Obsidian文档库/附件/"地址
目前 ob 中 pandoc 插件导出 word 格式并包含本地图片，只有以上这几种方式可以正确识别并导出。
下面用表格更清楚展示：
| 插件设置的源格式 | md 文档中的图片格式 | 导出结果 |
|---|---|---|
| html | ![[附件/202111241058704.png]] | 成功 |
| html | ![[202111241058704.png]] | 失败 |
| markdown |  | 直接导出失败 添加参数 --resource-path="E:\Obsidian文档库\" 成功 |
| markdown | ![[附件/202111241058704.png]] | 导出成功，但 wiki 格式图片不识别 |
| markdown |  | 直接导出失败 添加参数 --resource-path="E:\Obsidian文档库\附件\" 成功 |
| markdown |  | 失败，删除 file:/// 协议，导出成功 |
常见问题：
Info介绍个简单的办法，不用手动改引用文件的路径：
在 ob 的设置里，在“文件与链接”这一项里，把内部链接类型改成“基于仓库根目录的绝对路径”。然后 MD 就可以直接成功导出（html 为源格式）而不用另外设置了。
其实就是对应的表格第一行的情况。
如果库名称包含空格会导出失败?
解决办法：用%20 代替空格即可
讨论
若阁下有独到的见解或新颖的想法，诚邀您在文章下方留言，与大家共同探讨。
