Atom的markdown-preview-plus插件默认不渲染LaTeX公式,必须手动启用MathJax或KaTeX并配置语法格式(如$...$需空格、$$...$$需空行),且常因Math Processing Delay为0导致公式闪退,调至300以上方可稳定显示。

Atom 的 markdown-preview-plus 插件本身不直接渲染 LaTeX 数学公式,必须配合 MathJax 或 KaTeX 才能显示,且默认配置下几乎必然失败——这是绝大多数人卡住的第一步。
为什么写好 $...$ 但预览里只显示原始符号?
因为插件默认禁用内联数学解析,且未加载任何数学渲染引擎。即使你写了 $E = mc^2$,它也会原样输出,不会转成公式。
- 确认插件已启用:打开 Atom 设置 → Packages → 搜索
markdown-preview-plus→ 确保状态为 “Enabled” - 必须手动开启数学支持:在插件设置页勾选
Enable MathJax(或Enable KaTeX),二者选其一即可,不要同时开 - MathJax 渲染更兼容但稍慢;KaTeX 更快但对某些宏(如
ewcommand)支持有限 - 若勾选后仍不生效,检查是否被其他插件干扰(如
language-markdown的旧版本可能冲突)
行内公式和独立公式怎么写才有效?
语法本身遵循标准 Markdown + LaTeX,但需注意空格、换行和包裹方式,markdown-preview-plus 对格式敏感。
- 行内公式用单美元符:
$a^2 + b^2 = c^2$(前后不能紧贴文字,建议加空格:解为 $x=1$。) - 独立公式用双美元符:
$$int_0^infty e^{-x^2} dx = rac{sqrt{pi}}{2}$$,且前后必须是空行 - 避免在公式内使用反斜杠转义 Markdown 符号(如
*),LaTeX 自身已处理;但不要在公式外用$$包裹带星号的列表项 - 如果用了 KaTeX,
egin{equation}...end{equation}不被支持,改用$$...$$或$...$
自定义宏或字体不生效怎么办?
MathJax 支持配置块,但 markdown-preview-plus 不读取外部 mathjax-config.js,只能通过插件设置页的 MathJax Configuration 文本框注入。
- 在插件设置中找到
MathJax Configuration字段,填入合法 JSON(不是 JavaScript): { "tex": { "macros": { "R": "{\mathbb{R}}", "abs": ["{\lvert #1 \rvert}", 1] } } }- 注意:JSON 中键名必须用双引号,函数参数占位符用
#1,不是$1 - 修改后需重启预览窗口(关闭再打开
Markdown Preview标签页),热重载不生效 - KaTeX 不支持运行时宏定义,如需自定义命令,只能选 MathJax
最常被忽略的是:插件设置里「Math Processing Delay」默认为 0,而 MathJax 初始化需要时间,尤其首次加载。如果公式闪一下就变回源码,把该值调到 300 以上再试。


















