mathjax必须使用v2 cdn,v3地址会导致markdownpreview插件完全不加载公式;配置需设为"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/mathjax.js?config=tex-ams_html",保存后重启sublime或执行update settings,并通过浏览器预览(非侧边栏),且行内公式$e=mc^2$严禁空格。

MathJax 配置必须用 v2 CDN,v3 地址会彻底失效
MarkdownPreview 插件当前(v3.0.x)只稳定兼容 MathJax v2,硬塞 v3 的 URL 会导致公式完全不加载,连控制台错误都看不到——页面静默跳过 JS 注入。
- ✅ 正确配置:
"mathjax CDN": "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js?config=TeX-AMS_HTML" - ❌ 错误写法:
"https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"(v3 地址,插件不识别) - 配置位置:Preferences → Package Settings → Markdown Preview → Settings – User
- 改完保存后,必须重启 Sublime 或执行
Markdown Preview: Update Settings,否则新配置不生效
行内公式 $E=mc^2$ 不能有空格,否则解析中断
MathJax v2 对行内公式语法极其敏感。哪怕一个空格,$ E = mc^2 $ 就会被当成普通文本,原样输出;只有紧贴的 $E=mc^2$ 才触发渲染。
将 Markdown 格式的回复转换为适合 Telegram 的富文本,避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
- ✅ 可用:
$\alpha + \beta$、$a\_b$(下划线必须转义) - ❌ 失效:
$ a^2 + b^2 = c^2 $、$a_b$(未转义,可能被 Markdown 解析为斜体) - 大括号
{}不是原生支持:写\lbrace a+b \rbrace或\left\{ a+b \right\},直接写{a+b}会被忽略
预览必须走浏览器,侧边栏永远不渲染公式
这是最常被卡住的点:点了 Preview in Sidebar,公式显示为源码,不是配置错了,而是该路径根本不加载 JS。
- ✅ 唯一有效方式:
Markdown Preview: Preview in Browser(命令面板或右键菜单) - ✅ 等效操作:右键 →
Open Preview in Browser - ❌ 完全无效:
Preview in Sidebar、LSP 悬浮提示、任何非浏览器环境 - 注意:首次必须手动执行一次浏览器预览,之后
enable_autoreload才能监听保存并刷新
文件没保存或语法没切对,预览命令直接失灵
插件只响应已保存的 .md 文件,且右下角状态栏必须明确显示 Markdown,不是 Plain text 或 Markdown GFM。
- ✅ 正确流程:先
Ctrl+S保存为xxx.md→ 点击右下角文字 → 选Markdown→ 再运行预览命令 - ❌ 常见失败:新建 tab 未保存就点预览;文件名是
readme.md但状态栏显示Plain text;装了冲突插件(如 OmniMarkupPreviewer)导致命令消失 - 验证是否生效:打开控制台
Ctrl+`,输入view.settings().get('syntax'),返回值应含Markdown










