Markdown Preview Plus 不支持 MathJax,Sublime Text 中实际可用的是 MarkdownPreview(无“Plus”),需安装正版、配置 v2.7.9 CDN 地址、通过浏览器预览且严格遵循公式语法。

Markdown Preview Plus 不支持 MathJax,别白费时间配
Sublime Text 里根本不存在官方或主流维护的 Markdown Preview Plus 插件——你搜到的多半是拼写混淆、过时 fork 或个人魔改版。真实可用且持续更新的是 MarkdownPreview(注意没有 “Plus”),由 sublimetext-markdown-preview 仓库维护。装错插件会导致:配置写了没生效、enable_mathjax 字段被忽略、预览始终显示原始 $E=mc^2$ 而不是渲染结果。
- 卸载所有名称含 “Preview Plus”“Enhanced Plus” 的插件,只保留
MarkdownPreview - 通过 Package Control → Install Package → 搜索
MarkdownPreview(作者:facelessuser)安装正版 - 检查插件目录:
Packages/MarkdownPreview/下应有js/math_config.js,否则说明安装不完整
MathJax v2.7.9 是唯一可靠选项,v3 地址直接失效
当前 MarkdownPreview v3.0.x 硬编码依赖 MathJax v2,默认配置只加载 TeX-AMS_HTML 预设。用 v3 的 CDN 地址(如 https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js)会导致 JS 加载失败,控制台报 ReferenceError: MathJax is not defined,公式块彻底空白。
- Settings – User 中必须写死 v2.7.9 地址:
"mathjax CDN": "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js?config=TeX-AMS_HTML" - 不要省略
?config=TeX-AMS_HTML—— 这是启用\begin{aligned}和基本 LaTeX 命令的关键参数 - 本地离线部署?别试。插件未提供 MathJax 本地路径支持,硬改
js数组会因路径解析失败而静默跳过
预览必须走浏览器,侧边栏永远不渲染公式
这是最常被忽略的致命点:Preview in Sidebar 是纯 HTML 渲染器,不执行任何 JS,MathJax.js 根本不会下载。你看到的 $$\int_0^\infty$$ 就是源码原样输出,不是“没配好”,而是压根没触发解析流程。
将任意网站转换为文件系统,自动抓取网站并将页面挂载为 Markdown 文件,可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。
- 必须用
Markdown Preview: Preview in Browser(Ctrl+Shift+P 输入执行) - 右键文件 →
Open Preview in Browser效果相同,且自动刷新 - 浏览器地址栏应显示
file:///...路径,开发者工具 Network 标签页能看到MathJax.js请求成功 - Chrome/Edge 用户需关闭
chrome://settings/privacy中的“使用预测服务加载网页”,否则本地file://协议会被拦截
公式语法容错率极低,空格和下划线就是拦路虎
MathJax v2 对输入极其敏感,一个空格、一个未转义符号就让整块公式退化为文本。这不是 bug,是 v2 解析器的设计限制。
- 行内公式严格要求
$E=mc^2$——$ E = mc^2 $(前后/中间有空格)→ 失效 - 块级公式必须独占一行且无干扰字符:
$$\frac{a}{b}$$✅,text $$\frac{a}{b}$$ more❌,$$$$. $$(句点紧贴)❌ - 下划线必须转义:
a_b被 Markdown 当斜体处理,得写成a\_b - 大括号不能裸写:
{a+b}不识别,要用\lbrace a+b \rbrace或\left\{ a+b \right\}
多行对齐只认 \begin{aligned}...\end{aligned},\begin{align} 会报 undefined control sequence —— 因为 AMS 扩展默认未启用,改配置也无效。









