Python subprocess调用pandoc转换md为pdf/html的异常问题咨询

1. PDF转换时图片加载失败 #

原因 #

pandoc 不会自动将传入的 Markdown 文件所在目录作为资源搜索根路径，默认以执行命令时的当前工作目录为基准查找图片等资源。即使图片和md文件放在同一目录，只要执行Python脚本/终端命令的路径不在test_1文件夹下，pandoc就会在命令执行的根目录查找test_t1.png，自然触发资源找不到的警告，这也是直接在命令行调用pandoc也报相同错误的原因。

解决方法 #

两种方案选其一即可：

• 显式指定资源搜索路径：在pandoc命令中追加--resource-path参数，告诉pandoc去哪个目录找图片等资源

subprocess.run([
    "pandoc", "test_1/test1_new.md",
    "-o", "test_1/testoutput.pdf",
    "--resource-path=test_1"
])

终端直接调用pandoc时同样追加该参数即可生效。

• 指定命令执行工作目录：调用subprocess时传入cwd参数，将执行路径切换到md文件所在目录，命令内直接使用文件名即可，不需要加目录前缀

subprocess.run([
    "pandoc", "test1_new.md",
    "-o", "testoutput.pdf"
], cwd="test_1")

2. HTML输出表格无边框 #

原因 #

pandoc 默认输出的HTML文件不内置任何CSS样式，原生<table>标签在浏览器的默认渲染规则下就是无边框状态，不属于转换错误。

解决方法 #

给输出的HTML添加基础表格样式即可，两种常用实现方式：

• 独立CSS文件方案（推荐）：
  1. 新建一个CSS文件（例如命名为style.css），写入基础表格样式：

  table {
    border-collapse: collapse;
    width: 100%;
    margin: 1em 0;
  }
  th, td {
    border: 1px solid #ddd;
    padding: 0.5em 1em;
    text-align: left;
  }
  th {
    background-color: #f5f5f5;
  }
  

  2. 转换HTML时追加-s（生成完整独立HTML文档）和-c（引入外部CSS）参数，建议同时加上--resource-path参数避免后续图片路径问题：

  subprocess.run([
      "pandoc", "test_1/test1_new.md",
      "-o", "test_1/testoutput.html",
      "--resource-path=test_1",
      "-s",
      "-c", "style.css"
  ])
  

• 内嵌样式方案（无需额外文件）：
  直接在Markdown文件末尾追加一段内嵌样式，pandoc转换时会自动识别并写入HTML：

  <style>
  table {border-collapse: collapse;}
  th, td {border: 1px solid #ccc; padding: 4px 8px;}
  </style>
  

  转换时不需要额外加参数，正常执行转换命令即可生效。

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