公式显示成普通文本时,要分开检查两件事:页面是否加载了 MathJax,以及传给渲染器的语法是否正确。这篇文章源于 2019 年的 MathJax-LaTeX 设置笔记,以下语法已于 2026 年 9 月 13 日重新核对。
Table of Contents
1. 检查现有安装
如果已经安装 MathJax-LaTeX,请打开设置,检查 MathJax 的加载方式。新站点应先在测试环境确认兼容性:WordPress 插件目录目前提示,该插件尚未针对最近三个 WordPress 主要版本进行测试。不要为了修复一篇文章,再安装一套公式渲染器。
2. 选择是否强制加载 MathJax
未启用 Force Load 时,只使用 MathJax 原生定界符的文章需要主动请求加载脚本。可在文章任意位置加入这个短代码:
[mathjax]
插件的 nomathjax 短代码会禁止整页加载其脚本,而不只是停用后面的某一节。需要渲染公式的文章不要加入它。插件自己的 latex 短代码也会请求加载 MathJax;只有美元符号并不会触发加载。
Use wp-latex syntax 选项启用的是下面这种兼容写法:
$latex E=mc^2$
它不会启用 $E=mc^2$ 这样的普通单美元符号行内公式;那属于另一项 MathJax 定界符设置。插件源码中可以看到加载标记和专门的 wp-latex 转换逻辑。

这张旧截图仅供查找设置,不代表当前安装环境已经通过兼容性测试。
3. 测试方程语法
在草稿中测试以下三种原生写法:前两种是独立显示公式,第三种是行内公式。请将它们放入需要排版的正文,而不是用于保留示例原文的 Code 代码区块。
$$E=mc^2$$
\[E=mc^2\]
\(E=mc^2\)
MathJax 2和当前 MathJax文档都列出了这些默认定界符,但网站可以覆盖它们。MathJax-LaTeX 1.3.13 使用的是 MathJax 2 集成,不能把新版配置原样粘贴到它的设置中。
本博客目前使用另一套 MathJax 集成,而不是这里介绍的旧插件设置。它的独立公式输出如下:
如果方程显示为纯文本,请检查以下几点:
- 预览保存后的页面,不要只看编辑器。检查反斜杠是否保留、公式是否被放进了代码示例。
- 在浏览器 Network 面板中查找 MathJax 脚本和失败请求。先解决脚本未加载或被拦截的问题,再调整公式语法。
- 核对当前渲染器的定界符、加载设置,以及是否存在整页停用短代码。在测试环境中一次只改一项。
- 修改后只清理受影响页面的缓存,再用新标签页和窄屏检查。保留原配置,方便撤回改动。
