如何调整pandoc资源路径解决图片路径同时适配网页与PDF导出问题

你提到的方案完全可行，不需要修改Markdown源文件中的图片路径即可同时满足网站部署和本地pandoc导出的需求。

实现原理 #

pandoc提供的--resource-path参数用于指定本地查找资源文件的根目录，当你将当前工作目录.追加到该参数后，pandoc解析到Markdown中以/开头的绝对路径图片时，会自动将路径开头的根路径映射到你指定的资源目录下，也就是说/assets/images/image.png会被pandoc映射为./assets/images/image.png进行本地查找，完全匹配你本地的文件存储结构，同时源文件保留/开头的路径不会影响网站部署的资源解析规则。

具体使用方法 #

导出PDF时只需在原有命令中增加--resource-path .参数即可，示例命令如下：

# Linux/macOS 环境
pandoc input.md -o output.pdf --resource-path .

# 若存在多个资源目录，可用冒号分隔路径
pandoc input.md -o output.pdf --resource-path .:./other-resources

# Windows 环境
pandoc input.md -o output.pdf --resource-path .

# 若存在多个资源目录，可用分号分隔路径
pandoc input.md -o output.pdf --resource-path .;./other-resources

如果后续有更复杂的路径替换需求，也可以通过pandoc的Lua过滤器实现批量路径修改，不过仅解决当前问题的话--resource-path方案足够简单高效。

内容的提问来源于stack exchange，提问作者waterwave1353