Pandoc 默认不支持 LaTeX 命令 \Iota（大写伊奥塔），导致数学公式渲染报错；本文提供两种可靠方案：通过 \def 定义宏或启用 MathJax/KaTeX 渲染引擎，确保希腊字母在 HTML 输出中正确显示。
pandoc 默认不支持 latex 命令 `\iota`（大写伊奥塔），导致数学公式渲染报错；本文提供两种可靠方案：通过 `\def` 定义宏或启用 mathjax/katex 渲染引擎，确保希腊字母在 html 输出中正确显示。
Pandoc 在将 Markdown 转换为 HTML 时，对 LaTeX 数学符号的支持基于其内置的轻量级解析器（TeX math parser），该解析器仅支持标准 LaTeX 数学命令子集。而 \Iota 并非 LaTeX 核心宏包（如 amsmath）中预定义的命令——它属于较冷门的希腊字母大写变体（对应小写 \iota），因此 Pandoc 报出如下警告：
[WARNING] Could not convert TeX math \Iota, rendering as TeX:
\Iota
^
unexpected control sequence \Iota这意味着 Pandoc 无法识别该命令，最终将其原样输出为纯文本，破坏公式结构与可读性。
✅ 方案一：使用 \def 在文档中手动定义（推荐用于简单场景）
在 Markdown 源文件顶部（任意数学环境之前）插入一行 LaTeX 原生定义：
$\def\Iota{I}$
Here is an equation: $\Iota + \alpha = \beta$⚠️ 注意：\def 必须出现在首个 $...$ 或 $$...$$ 数学块之前，且需以 $ 包裹（即作为内联数学内容），否则 Pandoc 不会解析。此定义作用于整个文档，所有后续 \Iota 将被替换为 I（大写拉丁 I）。若需真正呈现希腊字符（如 Unicode Ι），可改用：
$\def\Iota{\mathrm{Ι}}$ % 注意：Ι 是希腊大写 Iota（U+0399），非拉丁 I
✅ 方案二：启用外部数学渲染引擎（推荐用于复杂公式）
更健壮的方式是绕过 Pandoc 内置解析器，交由 MathJax 或 KaTeX 在浏览器端渲染。只需添加 --mathjax 或 --katex 参数：
pandoc Input.md -f markdown -o Output.html \ --template='templates pandoc/elegant_bootstrap_menu.html' \ --toc --standalone --mathjax
- --mathjax：自动注入 MathJax v3 CDN，支持完整 LaTeX 语法（包括 \Iota，前提是 MathJax 配置允许）；
- --katex：轻量级替代，需提前下载 KaTeX CSS/JS 或指定本地路径（如 --katex=katex/）；
- ✅ 优势：无需修改源 Markdown，支持 \Iota、\Digamma 等所有 Unicode 希腊大写字母命令；
- ? 提示：若使用自定义模板，请确保模板中保留 $math$ 占位符（如 ），或参考 Pandoc 手册 Math Rendering 配置 <script> 注入逻辑。</script>
? 总结与最佳实践
| 场景 | 推荐方案 | 说明 |
|---|---|---|
| 简单文档、少量特殊符号 | \def\Iota{I} | 零依赖，但仅适用于可映射为 ASCII 或 Unicode 字符的符号 |
| 学术写作、多公式、需高质量排版 | --mathjax | 兼容性最强，支持 \Iota、\varTheta、\hbar 等全部扩展命令 |
| 静态站点、离线部署 | --katex --katex-stylesheet=... | 无网络依赖，渲染更快，但部分命令需 KaTeX 1.0+ 支持 |
最后提醒：Pandoc 的 -f markdown 默认启用 tex_math_dollars 扩展，确保 $\Iota$ 被识别为数学模式；若禁用了该扩展，请显式添加 -f markdown+tex_math_dollars。正确配置后，\Iota 将稳定渲染为预期的希腊大写字母。
