OmniDocLaTeX公式在Word或网页里显示异常，先查什么
公式在 Markdown、Word 或网页里变成源码、方块或乱码时，多半是定界符、转义字符、渲染环境或字体出了问题。本文给出一张先查什么、后查什么的排查清单，并说明每一步为什么这样做。
把一篇写好的论文或讲义从 Markdown 搬到 Word，或者贴到网页上，公式突然变成一串 \frac{a}{b}，或者中间出现方框、问号，这是很多人都碰到过的情况。公式本身没有写错，只是在另一个环境里没有被正确识别。
这篇文章写给已经写过 LaTeX 公式、但在跨格式或跨页面时遇到显示问题的人。读完你能判断问题出在哪一层：是源文本的写法、Markdown 的转义、Word 的导入方式，还是网页的渲染环境。之后按清单逐项检查，大多数情况不用重写公式就能解决。
这里讲的是通用的排查思路，不依赖某一款具体软件。文末会提到 OmniDoc 的 UniDoc 网页编辑器和桌面客户端在哪些环节能帮上忙，但判断方法对任何工具都适用。
公式显示异常，是哪一层出了问题？一句话结论
先别急着重写公式：绝大多数异常来自“定界符、转义、渲染环境”三者之一，先定位是哪一层，再动手修。下表按你的实际情况给出推荐做法。
| 你的情况 | 推荐做法 | 原因 |
|---|---|---|
公式在源文件里就是原始代码，能看到 $ 和反斜杠 | 先检查定界符和转义，再换渲染环境预览 | 渲染器没有把它当成公式，问题在文本层 |
| Markdown 预览正常，导出到 Word 后乱了 | 在 Word 中把公式转换为公式对象，并核对每个公式 | Word 不直接渲染 LaTeX 文本，需要转换步骤 |
| 网页上公式变成方块、问号或少了符号 | 检查渲染脚本是否加载，并替换不被支持的命令 | 网页依赖脚本和字体，任何一环缺失都会这样 |
| 只有某几个公式出错 | 逐个单独渲染，找出出错的那一个 | 通常是个别命令或括号不匹配，不必整篇返工 |
| 整篇公式都出错 | 查渲染环境是否开启数学支持 | 全局问题往往是环境设置，而不是每个公式的写法 |
先判断是哪一种问题
拿到一份出错的文档，先对照下面的表格做初步判断，再进入具体排查。
| 症状 | 常见原因 | 怎么确认 |
|---|---|---|
公式原样显示，满屏 $、\alpha | 定界符没被识别，或渲染环境未开启数学支持 | 同一段文本放到支持公式的编辑器里看是否正常 |
公式中的 _、* 变成斜体或消失 | Markdown 把它们当成强调符号解析了 | 查看源文件里这些字符前后是否有转义或成对出现 |
反斜杠不见了，\\ 变成一个 \ | 文本经过转义处理，或复制时被改写 | 对比源文件和导出结果里同一位置的反斜杠数量 |
| Word 里看到的是一串普通字符 | 只是把源码粘贴进去，没有转为公式对象 | 点击公式，看它是否作为整体公式对象被选中 |
| 出现方框、问号或缺失符号 | 字体缺失，或使用了渲染环境不支持的命令 | 换一个标准符号测试，如 \alpha，看是否也出问题 |
| 只有行间公式异常，行内正常 | 公式跨行，或定界符之间夹了空行 | 检查公式前后是否有空行，以及换行位置 |
逐项排查和修复
建议按下面的顺序检查，先易后难。前几步不需要改动公式内容，做完再动公式本身。
- 确认源公式本身能渲染。 把出问题的那一个公式单独复制到支持 LaTeX 的编辑环境里预览。如果单独也报错，说明是公式写法问题，跳到下面的“公式写法”部分；如果单独正常，问题在传递过程中。
- 检查定界符是否成对。 行内公式用一对
$...$，独立成行的公式用$$...$$。常见错误是漏掉一个$，导致后面的所有文字都被当成公式，或者中文全角符号混入了公式里。用“查找”功能逐个数一下美元符号的数量，应当是偶数。 - 检查 Markdown 的转义。 在 Markdown 里，
_和*会被当作强调标记。如果公式里出现x_1 + y_1被渲染成斜体，就需要在公式内确保定界符完整，或者在支持的环境中使用对应的数学块语法。反斜杠同理：如果文本经过某个转换步骤，\\（换行命令）可能被合并成一个，导致矩阵或多行公式错位。 - 确认渲染环境是否开启数学支持。 很多 Markdown 预览器默认不解析公式，需要在设置或扩展中打开数学支持。这是“整篇公式都显示为源码”的常见原因。如果你在使用 OmniDoc 的 UniDoc 网页编辑器（app.unidoc.top），它支持公式、Word 与 LaTeX 的互相转换，可以先在那里核对公式是否能正常显示。
- 导入 Word 时转换为公式对象。 Word 不会把裸的 LaTeX 文本当成公式显示。正确的做法是先让公式以公式对象的形式出现在 Word 中：在导出或导入时选择支持公式转换的路径，再逐个点开公式检查。如果只是把源码粘贴进正文，它永远只会是文字。转换后，建议抽查三到五个复杂公式，特别是带分式、求和上下限和矩阵的公式。
- 网页中确认渲染脚本已加载。 如果你是自己搭建的网页或博客，需要在页面中引入一个数学渲染脚本，并确认它已经加载成功。打开浏览器的开发者工具查看是否有加载报错。脚本未加载时，公式通常会原样显示。
- 检查特殊命令和字体。 有些命令属于特定宏包，例如
\mathbb、\mathcal等，在某些渲染器里不被支持，会显示为红色错误或方框。遇到这类符号，可以换成通用写法，或者查阅所用渲染器的支持列表。字体缺失则会导致特殊符号显示为方块，换一种字体或确认系统已安装相应字体即可。
公式写法本身的问题
如果第 1 步发现公式单独也不能渲染，按下面的方向检查。
- 花括号不配对。 每个
{都要有对应的}，尤其是分式和上下标嵌套时，漏掉一个会让后面整段报错。 - 中文标点混入。 公式里的逗号、括号如果是全角的，渲染器可能无法识别。统一改成半角。
- 换行的位置。 行内公式中间不宜换行。如果一定要分行，改用行间公式的写法。
- 不要在公式里写中文长句。 需要插入文字时，使用文本命令包裹，避免直接把中文放进数学环境。
分段检查的小技巧
整篇文档出错时，不要逐个公式逐行核对。把文档按章节拆开，每次只保留一部分在目标环境中渲染，很快就能找到出错的段落。如果一篇 30 页的论文中只有某一节公式异常，这样做通常只需要几分钟。
怎样避免下次再出现
- 先在源头写标准的定界符。 行内用
$...$，独立公式用$$...$$，写完后用同一个环境预览一遍，再导出。 - 导出前做一次“单公式测试”。 抽两三个复杂公式，在目标环境中单独确认，比导出后整篇返工省时间。
- 记录你所用的环境。 同一份 Markdown，在一个渲染器里正常，换到另一个可能失效。把渲染器、导出格式和设置记在文档开头，方便以后排查。
- 避免手动改写反斜杠。 从其他地方复制公式时，先看看反斜杠是否完整，必要时在纯文本编辑器中核对。
- 长文档分批转换。 如果需要把整本讲义从 Markdown 转到 Word，建议分章节转换并逐章检查，而不是一次性导出。
- 需要处理 PDF 中的公式时，先确认文件类型。 扫描件里的公式无法直接复制成 LaTeX，需要先做 OCR 识别，识别结果同样需要逐个核对，重要内容请人工复查。OmniDoc 的桌面客户端（download.omnidoc.top）提供 OCR 功能，可以作为这一步的起点。
❓ 常见问题（FAQ）
1. 为什么我的公式在 Word 里是一串 LaTeX 代码？
这是因为 Word 不会自动把 LaTeX 文本渲染成公式，只是把它当作普通字符保存。需要通过转换步骤，让公式以公式对象的形式存在于 Word 中，才会按数学排版显示。
2. Markdown 公式预览正常，导出后却乱了，怎么办？
先确认导出路径是否支持公式转换，然后在导出后的文件中逐个检查公式。如果只有少数公式出错，多半是定界符或个别命令不被目标格式支持，单独修改这些公式即可。
3. 网页上公式显示成方块，是字体问题吗？
有可能，但更常见的是渲染脚本没有加载，或者使用了渲染器不支持的命令。先用一个标准符号测试，如果也显示为方块，再检查字体和脚本加载情况。
4. 为什么行内公式正常，行间公式却报错？
行间公式对换行和空行更敏感。检查公式前后是否有空行、定界符是否独占一行，以及公式内部是否有不被支持的换行写法。
5. 从 PDF 里复制的公式为什么不能直接用？
PDF 复制出来的通常是字符而不是原始的 LaTeX 代码，上下标、分式的结构会丢失。稳妥的做法是找到原始源文件；如果只能用 PDF，就需要手动重写，并逐个与原文核对，不能完全依赖自动识别的结果。
📝 总结
公式显示异常通常不是公式写错了，而是在传递过程中定界符、转义或渲染环境出了问题。按照“先确认源公式、再检查定界符和转义、最后核对目标环境”的顺序排查，多数问题都能在短时间内定位。养成导出前抽查公式的习惯，能让 LaTeX 公式在 Markdown、Word 和网页之间保持一致。
