使用subprocess调用pandoc转MD为PDF时图片资源获取失败求助

问题场景 #

通过Python的subprocess调用pandoc转换Markdown到PDF时，执行命令：

subprocess.run(["pandoc", "--standalone", "--pdf-engine=xelatex", "/file/path/file.md", "-o", "/file/path/file.pdf"])

出现警告：

[WARNING] Could not fetch resource 'image.png': replacing image with description

图片与Markdown文件处于同一目录，且转换为HTML时图片路径可正常解析。

核心原因 #

Pandoc处理PDF（依赖xelatex引擎）和HTML的资源查找逻辑不同：

• 转换HTML时，会自动以Markdown文件所在目录为基准解析相对路径；
• 转换PDF时，默认以subprocess运行的当前工作目录为基准查找图片，而非Markdown文件的目录。你直接传入了md文件的绝对路径，但没有调整工作目录，导致pandoc在脚本运行的目录下找image.png，自然找不到。

解决办法 #

1. 切换subprocess的工作目录到md文件所在路径

这是最推荐的方式，符合文件相对路径的使用习惯：

import os
md_file = "/file/path/file.md"
# 获取md文件所在的目录
md_dir = os.path.dirname(md_file)
subprocess.run(
    ["pandoc", "--standalone", "--pdf-engine=xelatex", "file.md", "-o", "file.pdf"],
    cwd=md_dir  # 指定执行命令的工作目录
)

2. 用--resource-path指定资源搜索路径

直接告诉pandoc去哪里找图片资源，无需切换工作目录：

subprocess.run(
    [
        "pandoc", "--standalone", "--pdf-engine=xelatex",
        "--resource-path=/file/path",  # 指定图片所在目录
        "/file/path/file.md", "-o", "/file/path/file.pdf"
    ]
)

3. 修改md文件中的图片绝对路径（不推荐）

将md里的![图片描述](image.png)改为![图片描述](/file/path/image.png)，但这种方式会让md文件的路径依赖固定，文件移动后会失效，灵活性差。

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