Pandoc转PDF时LaTeX数学分隔符$/$$被转义致数学模式失效

问题描述 #

使用Pandoc将包含拉丁/西里尔文文本、行内数学公式（$ ... $）和块级数学公式（$$ ... $$）的Markdown文件转PDF时，所有$被转义为\$，导致LaTeX无法进入数学模式，报错\symbb allowed only in math mode。

示例代码与环境 #

Markdown片段

#### 2.1.1 Tenzori: skalari, vektori, matrice i višeredni tenzori

**Tenzor** (eng. _tensor_) je generalizacija pojma niza brojeva i može se posmatrati kao višedimenzionalni niz. 

1. **Skalar** (rang 0): Obični realni ili kompleksni broj. Skalar se može predstaviti kao $ \alpha \in \mathbb{R} $ (ili $ \alpha \in \mathbb{C} $ u slučaju kompleksnih brojeva).
2. **Vektor** (rang 1): Niz brojeva koji tipično reprezentuje neku veličinu sa određenim brojem komponenti. Na primer, vektor dužine $n$ je $ \mathbf{x} \in \mathbb{R}^n $.
3. **Matrica** (rang 2): Dvodimenzionalni niz brojeva ...
4. **Višeredni tenzor** (rang $\geq 3$): ...

执行命令

pandoc in.md -o out.pdf --pdf-engine=xelatex -V mainfont="DejaVu Serif"

报错信息

! LaTeX Error: \symbb allowed only in math mode.

l.72  ...predstaviti kao \$ \alpha \in \mathbb
                                  ...

环境信息

pandoc 3.1.11.1
Features: +server +lua
Scripting engine: Lua 5.4

XeTeX 3.141592653-2.6-0.999996 (TeX Live 2024/nixos.org)
kpathsea version 6.4.0

（已安装NixOS Unstable的所有TeX包）

已尝试方案

使用--from=markdown+raw_tex+tex_math_dollars、--standalone等参数组合，但部分场景下仍存在转义问题。

解决方法 #

1. 精准配置输入格式扩展 #

明确启用tex_math_dollars扩展，同时禁用可能干扰的raw_tex（该扩展会让Pandoc优先识别原始LaTeX代码，可能破坏数学分隔符的识别逻辑），命令如下：

pandoc in.md -o out.pdf --pdf-engine=xelatex -V mainfont="DejaVu Serif" --from=markdown+tex_math_dollars-raw_tex

2. 添加YAML元数据指定数学处理方式 #

在Markdown文件开头添加YAML前置块，强制Pandoc用LaTeX规则处理数学公式：

---
math: latex
---

3. 优化数学公式格式 #

避免$与公式内容之间的冗余空格，将$ \alpha \in \mathbb{R} $改为$\alpha \in \mathbb{R}$，减少Pandoc误判分隔符的概率。

4. 验证公式识别正确性 #

先转换为HTML验证数学公式是否被正确识别：

pandoc in.md -o out.html --from=markdown+tex_math_dollars --mathjax

若HTML中公式正常渲染，说明问题出在LaTeX阶段，检查amssymb等数学包是否已安装（\mathbb{R}依赖该包）。

5. 最终推荐命令 #

结合上述优化，使用以下命令确保稳定性：

pandoc in.md -o out.pdf --pdf-engine=xelatex -V mainfont="DejaVu Serif" --from=markdown+tex_math_dollars --math=latex

版本兼容性说明 #

Pandoc 3.1.11.1版本的tex_math_dollars扩展无已知失效问题，若仍有异常，可清理Pandoc临时文件后重新尝试。

内容的提问来源于stack exchange，提问作者Nikola-Milovic