Pandoc 默认不支持部分非标准 LaTeX 希腊字母命令（如 Iota），需通过自定义宏或启用 MathJax/KaTeX 渲染来解决，本文提供两种稳定、可复用的解决方案。
上述摘要指出：pandoc 默认不支持部分非标准 latex 希腊字母命令（如 iota），需通过自定义宏或启用 mathjax/katex 渲染来解决，本文提供两种稳定、可复用的解决方案。
Pandoc 在将 Markdown 转换为 HTML 时，对数学公式的解析依赖于其内置的 LaTeX 数学引擎（默认为 texmath）。然而，该引擎仅支持标准 LaTeX 数学宏包（如 amsmath、amsfonts）中定义的命令，而 Iota 并非 LaTeX 标准命令——它既不在 amssymb 中，也不在 unicode-math 的默认映射里。因此，当 Pandoc 遇到 $Iota$ 时会报出类似以下警告：
[WARNING] Could not convert TeX math Iota, rendering as TeX:
Iota
^
unexpected control sequence Iota这表明 Pandoc 无法识别该命令，只能原样输出为未渲染的 LaTeX 源码。
✅ 解决方案一：注入 LaTeX 宏定义（轻量、离线友好）
最直接的方式是在文档中提前定义 Iota 为大写拉丁字母 I（因其视觉等效且语义常用）：
defIota{I}将此行插入 Markdown 文档开头的原始 LaTeX 区域（即使用 raw_tex 扩展），例如：
---
header-includes:
- defIota{I}
---
This is an equation: $Iota + lpha = eta$⚠️ 注意：确保启用了 raw_tex 扩展（Pandoc 2.10+ 默认启用），且该定义必须出现在首个含 Iota 的公式之前。若使用自定义模板（如 elegant_bootstrap_menu.html），也可将 defIota{I} 加入模板的
中 <script> 或 <style> 前的 <script type="text/x-mathjax-config"> 外部区域（仅限 MathJax 场景）。</script>
✅ 解决方案二：启用 MathJax 或 KaTeX 渲染（推荐用于复杂公式）
更健壮的方式是绕过 Pandoc 的本地数学解析，交由前端 JavaScript 渲染器处理。只需添加 --mathjax 或 --katex 参数：
pandoc Input.md -f markdown -o Output.html --template='templates pandoc/elegant_bootstrap_menu.html' --toc --standalone --mathjax # 或 --katex
- --mathjax：自动引入官方 MathJax v3 CDN，支持完整 LaTeX 语法（包括 Iota ——只要浏览器端 MathJax 配置允许）；
- --katex：轻量级替代，但 KaTeX 默认仍不支持 Iota；如需支持，须配合自定义宏（见下文）。
若选用 KaTeX 并需 Iota，可在 HTML 模板中扩展 KaTeX 配置：
<script>
window.katexOptions = {
macros: { "\Iota": "I" },
throwOnError: false
};
</script>
<script src="https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.js"></script>? 总结与最佳实践
| 方案 | 适用场景 | 是否需联网 | 是否支持 Iota | 维护成本 |
|---|---|---|---|---|
| defIota{I} + raw_tex | 简单文档、离线部署、无 JS 环境 | 否 | ✅（映射为 I） | 低（单行定义） |
| --mathjax | 学术写作、复杂公式、多符号需求 | 是（CDN） | ✅（MathJax 原生支持） | 极低（开箱即用） |
| --katex + 自定义 macro | 追求性能、可控 CDN、需 KaTeX 生态 | 是 | ✅（需手动配置） | 中（需改模板） |
? 提示：LaTeX 中标准大写希腊字母仅有 Gamma, Delta, Theta, Lambda, Xi, Pi, Sigma, Upsilon, Phi, Psi, Omega；Iota 和 Kappa 等属于非标准变体。若追求语义严谨，建议优先使用 Unicode 字符（如 Ι U+0399）或改用标准命令（如 mathrm{I}）。但对已有文档兼容性而言，宏定义是最小侵入式修复方案。
