MarkdownPreview首次预览必须手动触发，后续保存自动刷新；需确保文件已保存、右下角语法设为Markdown（GitHub flavored）、首次执行Preview in Browser命令，三者缺一不可。
MarkdownPreview首次预览必须手动触发
插件不会在你打开.md文件时自动弹出浏览器页面——这是硬性前提，跳过就卡死。所谓“实时”其实是“首次手动 + 后续保存自动刷新”的链路，不是开箱即用的监听模式。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Markdown Preview: Preview in Browser，回车执行一次 - 浏览器会以
file://协议打开 HTML 页面；若 URL 是http://localhost或含中文路径，后续保存大概率不刷新 - 该标签页必须保持打开状态；关掉再重开，就得重新手动触发一次
右下角语法识别错误是静默失效主因
哪怕文件名是 readme.md，只要右下角状态栏显示 Plain text，MarkdownPreview 就完全不响应任何命令——这不是 bug，是设计逻辑：它只对 text.html.markdown 作用域生效。
- 点击右下角文字 → 搜索
Markdown→ 选中Markdown (GitHub flavored)（推荐），不要选Markdown GFM或其他变体 - 想一劳永逸？打开一个已保存的
.md文件后，右下角点击 →Open all with current extension as…→Markdown - 快捷键
Ctrl+Alt+M默认只在此作用域下有效；语法不对，快捷键等于不存在
enable_autoreload 已废弃，配了反而崩溃
2026 年起，"enable_autoreload": true 不仅无效，还会导致 Sublime 在保存瞬间卡住甚至崩溃（尤其 Windows + ST4）。真正的刷新机制不依赖这个配置项，而是靠首次预览后注入的浏览器端轮询脚本。
- 别在
Preferences → Package Settings → Markdown Preview → Settings – User里写enable_autoreload - Chrome 用户若启用「严格隔离」或「阻止第三方 Cookie」，可能导致 reload 脚本加载失败；临时换 Edge/Firefox 测试更可靠
- 如果预览页没反应，打开浏览器开发者工具（
F12），看 Console 是否报net::err_file_not_found或 CORS 错误；有则说明协议或路径出问题
图片和公式路径必须从 .md 文件位置算起
MarkdownPreview 解析图片、CSS、JS 路径时，基准点永远是当前 .md 文件所在目录，不是项目根目录，也不是 Sublime 工作目录——这点和 VS Code 或 Typora 完全不同。
- 错误写法：
→ 若文件在/docs/intro.md，实际查找路径是/docs/images/logo.png - 正确写法示例：
或，确保路径能从.md文件位置出发抵达资源 - 数学公式需显式开启：
"enable_mathjax": true，否则$$E=mc^2$$会被当纯文本渲染
真正卡住人的从来不是配置多复杂，而是三件事没做全：文件已保存为 .md、右下角语法设成 Markdown、首次手动执行过 Markdown Preview: Preview in Browser。少一个，整个链路就断在起点。
