sublime text 需通过 markdownpreview 插件启用 mathjax 才能渲染 latex 公式,且必须使用 v2 cdn、严格语法(如 $e=mc^2$ 无空格、a\_b 要转义)、并通过浏览器预览触发渲染,侧边栏预览不支持。

Sublime Text 本身不渲染 Markdown,数学公式不显示不是插件没装对,而是根本没启用实时渲染——它连普通 Markdown 预览都要靠第三方插件,更别说 LaTeX 公式解析了。
MarkdownPreview 插件必须开启 mathjax 支持
默认安装 MarkdownPreview 后,$...$ 或 $$...$$ 会被原样输出,因为 MathJax 渲染是关闭的。
- 打开
Preferences → Package Settings → Markdown Preview → Settings – User - 确保配置里包含:
{ "enable_mathjax": true, "mathjax CDN": "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js?config=TeX-AMS_HTML" } - 注意:MathJax v3 的 URL 格式不同,
MarkdownPreview当前(v3.0.x)仅稳定支持 v2;用 v3 地址会导致公式完全不加载 - 改完保存,重启 Sublime 或按
ctrl+shift+p输入Markdown Preview: Update Settings重载
公式语法必须严格符合 MathJax v2 要求
常见“写了但不显示”,大概率是语法被当成纯文本吞掉了。
- 行内公式用
$E = mc^2$,不能有空格:$ E = mc^2 $会失效 - 独立公式块用
$$\int_0^\infty e^{-x}dx = 1$$,前后不能跟其他字符(比如$$...$$.中的句点会导致解析中断) - 下划线
_在 Markdown 里有特殊含义,写a_b前必须转义为a\_b,否则可能被解析成斜体 - 避免在公式中混用中文标点,尤其是全角括号、顿号、破折号
预览方式决定是否走 MathJax 流程
不是所有“预览”都触发数学渲染:
-
ctrl+shift+p → Markdown Preview: Preview in Browser✅ 走完整流程,支持 MathJax -
ctrl+shift+p → Markdown Preview: Preview in Sidebar❌ 侧边栏预览不加载 JS,公式只显示源码 - 右键菜单里的
Open Preview in Browser✅ 等效于命令面板的第一项 - 任何基于
sublime-markdown-popups的悬浮提示(如某些 LSP 插件)都不支持 MathJax
真正卡住人的地方往往不是配置错,而是预览路径选错了——以为点了“预览”就万事大吉,结果一直盯着侧边栏看空白公式块。










