Sublime Text 的 Markdown 预览依赖唯一插件 MarkdownPreview，需正确安装、重启、设为 Markdown 语法、保存为 .md 文件，并首次手动预览后才支持自动刷新；其他插件无效或冲突，中文需 UTF-8 编码，数学公式与 Mermaid 需手动启用。
Sublime Text 本身不渲染 Markdown，所谓“优雅写作”= 正确语法识别 + 单插件预览闭环 + 自动刷新不卡顿。装错插件、跳过首次手动预览、忽略浏览器策略，三者任一都会让预览失败。
只装 MarkdownPreview，别碰 MarkdownEditing 或 OmniMarkupPreviewer
很多人搜“markdown preview”装了名字相近的插件，结果命令面板里有条目、点了没反应——MarkdownEditing 只负责语法高亮和快捷键，完全不生成 HTML；OmniMarkupPreviewer 已多年未维护，与 ST4 冲突频发，常导致右键菜单消失或保存卡死。
真正起作用的只有 MarkdownPreview（注意拼写：结尾是 Preview，无空格、无 s、不是 Previewer）：
- 用
Package Control: Install Package安装时，必须输入MarkdownPreview（带大写 M 和 P，无空格） - 安装后必须完全退出 Sublime Text 再重开，否则
Ctrl+Shift+P搜不到Markdown Preview: Preview in Browser - 确认已启用：打开命令面板，输入
mp，能看到且能执行该命令
文件必须被识别为 Markdown，不是靠文件名，而是靠右下角状态栏
哪怕你打开的是 readme.md，只要右下角显示 Plain text，MarkdownPreview 就彻底静默——这不是 bug，是设计逻辑。
检查并修复方法：
- 点击右下角状态栏文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 新建未保存的 tab（如
untitled）永远无法触发预览，务必先Ctrl+S保存为.md后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown - 快捷键
Ctrl+Alt+M默认只在text.html.markdown作用域生效，语法不对，快捷键就等于不存在
"enable_autoreload": true 不是开关，而是监听前提
新版 MarkdownPreview（2026 年起）已废弃 "enable_autoreload": true 的独立生效能力。强行写入不仅无效，还会导致 Sublime 在保存瞬间卡住甚至崩溃。
真正自动刷新的链条是：
- 首次必须手动执行一次
Markdown Preview: Preview in Browser（之后才能监听） - 保持该浏览器标签页打开，且 URL 是
file://或http://127.0.0.1开头（http://localhost有时因端口冲突失败） - Chrome / Edge 用户若启用了“阻止第三方 Cookie”或“严格隔离”，reload 脚本可能失效（截至 2026 年 6 月 11 日）
- 无需额外装 LiveReload 插件——
MarkdownPreview自带 reload 脚本，只要首次预览成功、标签页开着、协议对，后续保存就会自动刷新
中文路径/内容出错？先切 UTF-8 编码
含中文路径或中文内容时，若文件编码为 GBK 或其它，预览会报错或空白，这不是插件问题，是 Python 解析器读取失败。
解决方式：
File → Reopen with Encoding → UTF-8- 再试
Markdown Preview: Preview in Browser - 如果仍失败，控制台输
import html.parser验证 Sublime 自带 Python 是否完整（某些精简版或 macOS M1 安装包缺该模块）
数学公式和 Mermaid 图表默认关闭，需手动在 MarkdownPreview.sublime-settings 中开启 "mathjax_enabled": true 或 "mermaid_enabled": true，否则对应语法不渲染。
