Sublime怎么解决Markdown数学公式不显示_Sublime插件配置【建议收藏】

1次阅读

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

Sublime怎么解决Markdown数学公式不显示_Sublime插件配置【建议收藏】

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

真正卡住人的地方往往不是配置错,而是预览路径选错了——以为点了“预览”就万事大吉,结果一直盯着侧边栏看空白公式块。

text=ZqhQzanResources