Markdown 公式转 Word 后显示为源码？LaTeX 语法与公式转换排查指南
Markdown 文档中的公式在编辑器里看起来完全正常，转换成 Word 后却可能仍然显示为 LaTeX 源码。DOCX 中没有排版后的数学公式，只剩下 \frac{a}{b}、美元符号、反斜杠或不完整的数学表达式。
这通常表示公式在生成 Word 之前没有被识别为数学内容。源文件可能使用了错误的定界符，把公式放进代码块，混用了多种数学语法，或者依赖无法稳定映射到 Word 的复杂 LaTeX 命令。
统一使用行内公式和块级公式定界符；不要把需要渲染的公式放进代码块；确认每个定界符和大括号都已闭合；把自定义宏替换为标准命令；先单独测试一条失败公式。
只有先被识别为数学内容，LaTeX 源码才能转换为排版后的 Word 公式。为什么公式会变成普通文本
Markdown 转换程序不会把所有反斜杠和数学符号都自动当成公式。它首先需要解析文档，判断一段内容属于普通文字、代码、行内公式还是块级公式。
公式显示为源码的常见原因包括：
- 开头或结尾缺少数学定界符。
- 公式被放进反引号或围栏代码块。
- 美元符号既表示货币，又被识别为数学定界符。
- 文档中混用了
$...$、$$...$$、\(...\)和\[...\]。 - 使用了转换程序无法识别的自定义 LaTeX 宏。
- 大括号、环境或命令没有完整闭合。
- 公式来自另一种使用不同数学语法的编辑器。
因此，第一步不是在 Word 中手工重新输入公式，而是确认 Markdown 源文件中的数学表达式是否规范且一致。
行内公式与块级公式不是一回事
行内公式位于普通句子内部，块级公式则单独占据一行，通常用于更重要或结构更复杂的数学表达式。
行内公式
平均值为 $\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i$。
这条公式属于正文的一部分，一般不需要单独换行。
块级公式
$$ E = mc^2 $$
将块级公式的开始和结束定界符分别放在独立行，可以减少与正文标点和相邻内容之间的歧义。
即使转换工具支持多种定界符，频繁混用也会增加修改和排查难度。建议统一一种行内公式写法和一种块级公式写法。
问题一：定界符缺失或不匹配
每个开始定界符都必须有对应的结束定界符。只缺少一个美元符号，就可能导致当前公式甚至后续整段内容被错误识别。
错误写法
计算结果为 $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}。
正确写法
计算结果为 $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$。
中文句号放在结束定界符之后，可以让公式边界更加明确。
问题二：公式被放进代码块
反引号的含义是“按原样显示这段内容”。它适合展示 LaTeX 源码，却会阻止同一段内容被识别为数学公式。
作为代码显示
`$a^2 + b^2 = c^2$`
作为公式识别
$a^2 + b^2 = c^2$
如果一篇教程需要同时展示源码和公式结果，应在代码块中放置一份源码，再在代码块外单独放置一份用于公式转换。
代码块会原样保留 LaTeX；数学定界符则允许转换程序把内容识别为公式。问题三：货币美元符号与数学定界符混淆
美元符号既可以表示货币，也可以作为数学公式定界符。因此，同时包含价格和公式的段落需要特别检查。
价格从 $40 上升到 $50，同时 $x = 10$。
很多解析器能够正确处理这种情况，但从其他系统复制来的内容、空格不规范或定界符缺失时，仍可能发生误判。
普通货币金额不应该为了视觉统一而被成对美元符号包围。在技术表格中，为减少歧义，也可以使用 USD 40 这类货币代码写法。
问题四：大括号或命令没有闭合
LaTeX 经常使用大括号组织分子、分母、上标、下标、根号和矩阵内容。任何一个大括号缺失，都可能导致公式无法正确解析。
| 错误写法 | 正确写法 |
|---|---|
\frac{a+b}{c |
\frac{a+b}{c} |
x^{n+1 |
x^{n+1} |
\sqrt{x^2+y^2 |
\sqrt{x^2+y^2} |
x_{i+1 |
x_{i+1} |
对于很长的公式，可以使用具有括号匹配提示的编辑器，或者在语法允许的情况下把源码拆成多行，便于逐组检查。
问题五：使用了不受支持的自定义宏
完整 LaTeX 项目可以在导言区定义自定义命令，但独立 Markdown 文件通常不包含相同的宏环境。原本在 TeX 项目中有效的命令，在 DOCX 转换时可能无法识别。
依赖自定义宏
$\vect{x} + \vect{y}$
如果 \vect 是在其他文件中定义的，转换程序可能不知道它的含义。
改成标准命令
$\mathbf{x} + \mathbf{y}$
当文档可移植性比保持简短 TeX 源码更重要时，应优先使用通用标准命令。
问题六：公式环境过于复杂
大型 LaTeX 环境可能包含对齐方式、编号、间距控制、特定宏包命令和多层嵌套结构，这些功能不一定都能直接映射为可编辑 Word 公式。
转换前可以进行以下简化：
- 删除只用于 TeX 视觉排版的手工间距命令。
- 删除与数学含义无关的宏包专用命令。
- 把很长的对齐推导拆成多个公式。
- 优先使用标准分数、根号、求和、积分、矩阵、上下标。
- 把解释性文字移到公式外的普通段落中。
能够在 Word 中继续编辑和阅读的简化公式，通常比视觉效果完全一致、但只能作为图片或直接转换失败的复杂公式更实用。
问题七：公式太长，超出页面宽度
公式成功转换，不代表最终页面布局一定合理。Word 页面宽度有限，过长且无法自然断开的公式可能进入页边距，或者被压缩得难以阅读。
更合理的处理方式包括：
- 引入中间变量。
- 把推导拆成多个块级公式。
- 把条件和定义移到公式前后的正文中。
- 把矩阵与使用该矩阵的公式分开显示。
- 不要为了一个长公式而缩小整篇文档字号。
对长公式应进行单独转换测试，并在 Word 中实际检查宽度，而不是只根据解析成功判断结果。
更可靠的公式测试流程
- 找到第一条失败公式。不要一开始就修改文档里的全部公式。
- 复制到最小 Markdown 文件。删除无关标题、表格和代码。
- 检查定界符。确认开始与结束标记完全匹配。
- 删除代码格式。确认公式不在反引号或围栏代码块中。
- 检查大括号和命令。把自定义宏展开为标准 LaTeX。
- 简化公式。删除不影响数学含义的间距和排版命令。
- 转换最小文件。确认公式能够生成并继续编辑。
- 把修正后的源码放回完整文档。再继续检查下一条失败公式。
先单独测试一条失败公式，再修改完整 Markdown 文档。在最终 DOCX 中检查公式
预览看起来正确并不是唯一标准。应打开生成的 DOCX，确认公式在实际使用的文字处理软件中表现正常。
- 确认文档中没有残留美元符号或 LaTeX 命令。
- 点击公式，检查是否可以继续编辑。
- 检查分数、根号、上下标、求和和积分。
- 检查矩阵和对齐公式是否缺少行或列。
- 确认长公式没有超出页面边距。
- 使用公式编号时，检查编号和正文引用。
- 条件允许时，在收件人实际使用的 Word 或 WPS 中打开。
- 公式排版正确后，仍需单独核实数学内容。
常见现象与可能原因
| 现象 | 可能原因 | 优先处理方式 |
|---|---|---|
| 美元符号仍然显示 | 内容没有被识别为公式 | 检查定界符和相邻空格 |
| 公式以等宽字体显示 | 内容位于代码块或代码片段中 | 删除反引号或代码围栏 |
| 只有某个命令显示为源码 | 使用了不支持的自定义宏 | 改用标准 LaTeX 命令 |
| 公式被截断或结构异常 | 缺少大括号或环境未闭合 | 逐字符检查各个表达式分组 |
| 公式正常生成但超出页面 | 表达式对于当前页面过长 | 拆分推导或引入中间变量 |
常见问题
为什么 LaTeX 公式在 Word 中显示为普通文本？
源码很可能没有被识别为数学内容。应检查定界符、反引号、代码块、自定义命令、大括号和混用的数学语法。
转换后的 Word 公式可以编辑吗？
受支持的数学表达式可以保持可编辑。复杂或不受支持的 LaTeX 功能可能需要简化，最终仍应在 DOCX 中检查。
应该使用单美元符号还是双美元符号？
选择当前文档支持的规则时，通常使用单美元符号表示行内公式，双美元符号表示块级公式。关键是语法一致并且完整闭合。
所有 LaTeX 宏包命令都能转换到 Word 吗？
不能。特定宏包命令和自定义宏可能没有直接对应的 Word 结构。标准数学语法通常具有更好的可移植性。
最终检查清单
- 行内公式和块级公式采用统一定界符。
- 所有定界符和大括号均已正确闭合。
- 需要渲染的公式没有放在代码块中。
- 自定义宏已经替换为标准命令。
- 超长公式已经进行简化或拆分。
- 失败公式已经在最小 Markdown 文件中单独测试。
- 最终公式已在 Word 中检查可编辑性和准确性。
Pandoc 用户指南中的数学语法与 DOCX 转换说明，以及 Microsoft Word 公式编辑文档。
