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 要求

常见“写了但不显示”，大概率是语法被当成纯文本吞掉了。

Markdown Docs Full-Text Search

使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索，适用于需要快速、高效搜索大量 Markdown 文章的场景。

下载

• 行内公式用 $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

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