sublime text需markdownpreview插件+mathjax v2.7.9+浏览器预览三者协同才能渲染数学公式;装错插件、用错cdn或误用侧边栏预览均会导致公式不显示。

Sublime Text 本身不支持数学公式渲染,必须靠 MarkdownPreview 插件 + MathJax v2.7.9 + 浏览器预览三者协同才能生效;装错插件、用错 CDN、点错预览方式,任一环节出错都会导致公式原样显示为 $E=mc^2$。
只装 MarkdownPreview,别碰 “Preview Plus”
网上搜到的 Markdown Preview Plus 是拼写混淆或过时魔改版,Sublime 官方生态中不存在该插件。它不会加载 MathJax,配置里的 enable_mathjax 字段会被完全忽略。
- 通过
Package Control → Install Package搜索并安装MarkdownPreview(作者:facelessuser) - 卸载所有含
Preview Plus、Enhanced Plus名称的插件 - 安装后检查插件目录:
Packages/MarkdownPreview/js/math_config.js必须存在,否则说明安装不完整
MathJax CDN 必须用 v2.7.9,且带完整 config 参数
MarkdownPreview v3.0.x 硬编码适配 MathJax v2,用 v3 地址(如 https://cdn.jsdelivr.net/npm/mathjax@3/...)会导致控制台报 ReferenceError: MathJax is not defined,公式块彻底空白。
输入文章 URL,返回干净 Markdown。支持17个平台(头条、微信公众号、知乎、36kr、虎嗅、华尔街见闻、澎湃、InfoQ 等)专项优化,双引擎提取、图片本地化、三层抓取策略。常与 browser‑web‑search skill配合:先用 bws 搜索获取 url 列表,再逐篇调用本 skill 提取正文。
- 打开
Preferences → Package Settings → Markdown Preview → Settings – User - 写死以下配置(注意:不能省略
?config=TeX-AMS_HTML):{ "enable_mathjax": true, "mathjax CDN": "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js?config=TeX-AMS_HTML" } - 保存后按
Ctrl+Shift+P输入Markdown Preview: Update Settings重载,或重启 Sublime
公式语法容错率极低,空格和下划线就是硬伤
不是“写对了但没显示”,而是解析器在第一步就跳过了整段——因为格式不满足 MathJax v2 的严格要求。
- 行内公式:
$E=mc^2$✅;$ E = mc^2 $❌(前后空格中断匹配) - 块级公式:
$$\int_0^\infty e^{-x}dx = 1$$✅;$$$$. $$❌(句点、换行、多余$都会失效) - 下划线必须转义:
a\_b✅;a_b❌(否则被 Markdown 当成斜体或直接丢弃) - 大括号要用
\lbrace/\rbrace或\left\{/\right\},原生{a+b}不识别 - 多行对齐只能用
\begin{aligned}...\end{aligned},\begin{align}默认不启用
必须用浏览器预览,侧边栏永远不渲染公式
这是最常被忽略的致命点:Preview in Sidebar 是纯 HTML 渲染器,不执行 JS,MathJax.js 根本不会下载。你看到的 $$\int$$ 就是源码原样输出,不是“配置失败”,而是流程压根没启动。
- 正确方式只有两个:
Ctrl+Shift+P → Markdown Preview: Preview in Browser,或右键文件 →Open Preview in Browser - 浏览器地址栏应显示
file:///路径;打开开发者工具 →Network标签页,确认能看到MathJax.js请求成功 - Chrome/Edge 用户需关闭
chrome://settings/privacy中的“使用预测服务加载网页”,否则file://协议会被拦截
真正卡住人的地方,往往不是配置写错了,而是以为点了“预览”就完成了——结果一直盯着侧边栏看原始代码,连 MathJax 的请求都没发出去。










