必须安装拼写为markdownpreview（无空格、无s、非previewer）的插件，安装后需完全重启sublime，文件须保存为.md后缀并手动设为纯markdown语法，首次必须手动执行preview in browser才能启用自动刷新。
MarkdownPreview插件必须装对，拼写错一个字母就白装
Sublime Text 本身不处理 Markdown 渲染，所有预览能力都依赖 MarkdownPreview 插件——注意结尾是 Preview，不是 Previewer，不带空格、没有复数 s。搜 markdown preview（带空格）或装 OmniMarkupPreviewer、MarkdownEditing 都无效：MarkdownEditing 只管语法高亮，OmniMarkupPreviewer 已多年未维护，ST4 上常导致右键菜单消失或保存卡死。
安装路径唯一正确：按 Ctrl+Shift+P → 输入 Package Control: Install Package → 粘贴 MarkdownPreview（严格大小写）→ 回车。装完必须完全退出 Sublime 再重开，否则命令面板搜不到 Markdown Preview: Preview in Browser。
文件没被识别为 Markdown，插件直接静默
哪怕你打开的是 readme.md，只要右下角状态栏显示 Plain text，MarkdownPreview 就不会响应任何命令——这不是 bug，是设计逻辑。它只在 text.html.markdown 作用域下工作。
- 点击右下角状态栏文字 → 搜索
Markdown→ 选中纯Markdown（不是Markdown GFM或其他变体） - 新建未保存的 tab（如
untitled）永远无法触发预览，必须先Ctrl+S保存为.md后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown
“实时刷新”根本不是配个开关就能开的
2026 年起，"enable_autoreload": true 已被彻底废弃。写进 Settings – User 不仅无效，还会让 Sublime 在保存瞬间卡住甚至崩溃（尤其 ST4 + Windows）。所谓“实时”，其实是浏览器端原生 reload 的结果，前提是：
- 必须手动执行一次
Markdown Preview: Preview in Browser（这是硬前提，跳过就全废） - 浏览器标签页必须保持打开，且 URL 是
file://或http://127.0.0.1开头（http://localhost易因端口冲突失败） - 含中文路径或中文内容时，文件编码必须为
UTF-8（File → Reopen with Encoding → UTF-8）
数学公式和 Mermaid 图表要单独启用
MarkdownPreview 默认不渲染 $...$ 数学公式和 mermaid 图表，必须手动开启对应配置项。打开 Preferences → Package Settings → Markdown Preview → Settings – User，添加：
{
"mathjax_enabled": true,
"mermaid_enabled": true
}
注意：mathjax_enabled 依赖网络加载 MathJax CDN，若离线写作需提前配置本地路径；mermaid_enabled 要求浏览器支持 ES6，旧版 IE 或禁用 JS 的环境会空白。这两项和自动刷新无关，但一旦开了 "enable_autoreload": true，反而会干扰它们生效。
