sublime text 本身不支持 markdown 实时预览，必须通过 markdownpreview 插件配合浏览器实现伪实时效果；需先手动触发首次预览、确保文件语法识别为 markdown、保存为 .md 后缀，并保持浏览器标签页打开，缺一不可。
Sublime Text 本身不提供 Markdown 实时预览能力，所谓“同步浏览器显示”必须靠 MarkdownPreview 插件 + 浏览器配合实现，且“实时”是伪实时——它依赖手动触发首次预览、文件保存事件监听、以及浏览器端 reload 脚本协同工作；跳过任意一环，预览就卡死或空白。
装对插件：只认 MarkdownPreview，别碰 MarkdownEditing 或 OmniMarkupPreviewer
很多人搜“markdown preview”装错，结果命令面板里有名字、点了没反应。真正起作用的只有 MarkdownPreview（注意结尾是 Preview，无空格、无 s、不是 Previewer）：
-
MarkdownEditing只负责语法高亮和快捷键增强，完全不生成 HTML，也不打开浏览器 -
OmniMarkupPreviewer已多年未维护，与 ST4 兼容性差，常导致右键菜单消失或快捷键冲突 - 安装后必须完全退出 Sublime 再重开，否则
Ctrl+Shift+P搜不到Markdown Preview: Preview in Browser - 用 Package Control 安装时，输入的是
MarkdownPreview，不是markdown preview（带空格会搜不到）
文件必须被识别为 Markdown：看右下角状态栏，不是文件名
哪怕你打开的是 readme.md，只要右下角显示 Plain text，MarkdownPreview 就彻底静默。这不是 bug，是设计逻辑：
- 点击右下角文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 未保存的临时文件（如
untitled）永远无法触发预览，务必先Ctrl+S保存为.md后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown - 快捷键
Ctrl+Alt+M默认只在text.html.markdown作用域生效，语法不对，快捷键就等于不存在
“自动刷新”根本不是配置开关的事：首次手动预览是硬前提
新版 MarkdownPreview（2026 年起）已废弃 "enable_autoreload": true 配置项。强行写入不仅无效，还会导致 Sublime 在保存瞬间卡住甚至崩溃：
- 真正起作用的流程是：
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车（必须做一次） - 之后只要该浏览器标签页保持打开，且 URL 是
file://或http://127.0.0.1开头，每次保存就会自动刷新 -
http://localhost有时因端口冲突失败，优先用file://协议 - Chrome 用户若启用了“阻止第三方 Cookie”或“严格隔离”，reload 脚本可能加载失败；可临时禁用，或换 Edge/Firefox 测试
图片不显示、公式不渲染、样式乱码？路径和解析器没对齐
渲染失败很少是插件问题，多是环境没对齐：
- 图片路径按
.md文件所在目录解析，不是项目根目录——比如/docs/readme.md里写，插件会找/docs/img/logo.png - 数学公式需显式开启：
"mathjax_enabled": true，但离线时 MathJax CDN 加载失败，建议配本地副本或改用 KaTeX - Mermaid 图表默认不启用，要加
"mermaid_enabled": true，且需确保浏览器支持 ES2015+ - 中文乱码大概率是文件编码非 UTF-8：菜单 →
File → Reopen with Encoding → UTF-8
最易被忽略的一点：所有“实时”效果都建立在浏览器标签页持续存活的基础上。关掉那个预览页，再改文件，就不会刷新——它不是后台服务，没有独立进程，只是前端脚本轮询一个本地 HTML 文件是否更新。你得始终留着那个 tab。
