使用--mathjax与--template的pandoc无法渲染公式问题

问题原因 #

1. 公式未解析：使用自定义模板时，Pandoc不会自动插入MathJax的渲染脚本，必须手动在模板中声明对应变量；额外的LaTeX中转步骤不仅冗余，还可能丢失Markdown原生的公式标记信息。
2. CSS未生效：模板中的<base href="/">会导致本地文件加载CSS时指向系统根目录，而非当前文件所在目录，路径匹配失败。

解决方案 #

1. 简化转换命令 #

直接从Markdown生成HTML，跳过中间LaTeX文件的生成步骤：

pandoc --template=template.html --mathjax stuff.md -f markdown -t html -s -o stuff.html

2. 修改自定义模板template.html #

调整两处关键内容：

• 替换硬编码标题为Pandoc元数据变量，同时加入MathJax脚本注入点
• 修正base href路径以适配本地文件加载

修改后的模板代码：

<!doctype html>
<html lang="en">

<head>
  <meta charset="utf-8">
  <!-- 本地打开时使用相对路径，确保CSS能正确加载 -->
  <base href="./">
  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  <link rel="stylesheet" href="template.css">
  <!-- 从Markdown元数据中读取标题 -->
  <title>$title$ website</title>
  <!-- 让Pandoc自动插入MathJax渲染脚本 -->
  $mathjax$
</head>

<body class="body">
  <div class="header-container">
    <div class="header">
      bla header
    </div>
  </div>

  <div class="heart-container">
    <div class="heart">
      $body$
    </div>
  </div>
</body>
</html>

3. 验证效果 #

运行修改后的命令后：

• LaTeX公式会被MathJax正确渲染
• CSS定义的黑色背景、绿色文字等样式会正常应用

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