MarkdownPreview中LaTeX公式不渲染的根本原因是mathjax_enabled默认为false，必须在Settings–User中显式配置{"mathjax_enabled":true}，并配合include_mathjax、语法规范、文件保存、UTF-8编码及手动触发预览等完整条件才能生效。

MarkdownPreview 必须启用 mathjax_enabled

LaTeX 公式不渲染，根本原因不是插件没装，而是 mathjax_enabled 默认为 false。即使你已装好 MarkdownPreview，不显式开启，$$E = mc^2$$ 就只会原样显示为文本。

• Preferences → Package Settings → Markdown Preview → Settings – User 中必须写入：
  

  { "mathjax_enabled": true }

• 仅靠 mathjax_enabled 不够：若用 CDN 方式（推荐），还需确保 "include_mathjax": "cdn"；若离线使用，得手动指定本地路径，且 MathJax v3.x 是唯一兼容当前 ST4 的版本
• 公式语法必须严格：$E=mc^2$ 不能有空格，a_b 要写成 a\_b（下划线需转义），否则解析失败

首次预览必须手动触发，否则 mathjax 脚本不加载

浏览器里公式空白？大概率是只配了设置，却没真正打开过预览页——mathjax 脚本只在 Markdown Preview: Preview in Browser 执行后注入 HTML，未触发就等于没启动。

• 文件必须已保存，后缀为 .md 或 .markdown
• 右下角状态栏必须显示 Markdown（不是 Plain text），点它 → Set Syntax → Markdown (GitHub flavored)
• 编码必须是 UTF-8：含中文时若为 GBK，整个页面可能空白；File → Reopen with Encoding → UTF-8 再试

enable_autoreload 已废弃，别再配它

2026 年起，"enable_autoreload": true 不仅无效，还会导致 Sublime 在保存瞬间卡死或崩溃（尤其 Windows + ST4）。所谓“自动刷新”实际依赖浏览器端轮询，而该机制早已被移除。

Markdown to PDF Converter (v2.0)

离线Markdown转PDF转换器，基于Pandoc与WeasyPrint，支持完整Unicode及本地表情缓存，可将Markdown转为专业级PDF...

下载

• 真实可用的方案只有两种：
  ① 手动刷新浏览器（F5）
  ② 配合 LiveReload 浏览器扩展（Chrome/Edge/Firefox 均支持），并在插件中启用 Simple Reload
• LiveReload 扩展若不起作用，先检查是否启用了“严格隔离”或“阻止第三方 Cookie”，这些策略会拦截重载脚本；临时关闭或换 Edge 测试更可靠
• 不要试图在配置里加 "enable_autoreload"，哪怕注释掉也比留着强

图片路径和公式共存时容易出错

公式能渲染但图片不显示？这不是 MathJax 的问题，而是路径解析逻辑冲突：MarkdownPreview 渲染时，所有相对路径（包括 ![](img/equation.png)）都以 .md 文件所在目录为基准，而 MathJax 的 CDN 资源走的是网络请求，二者互不影响，但调试时容易混淆。

• 打开浏览器开发者工具（F12），切到 Network 面板，筛选 Img，看是否有 404 —— 有则说明图片路径错了
• 公式块内嵌图片（如 $$\includegraphics{fig1}$$）不被支持；LaTeX 图片必须用标准 Markdown 语法插入
• 如果用本地 MathJax 离线包，确保其路径不与图片路径冲突（例如不要把 mathjax 文件夹也放在 ./img/ 下）

公式能跑通不代表整个流程稳了——最常被忽略的是首次预览后的浏览器标签页必须保持打开状态，关掉再开就得重新触发，而且每次新开标签页都不会继承之前的 reload 状态。