必须先保存为.md文件并设右下角语法为markdown，再手动执行一次preview in browser命令，之后保存才触发自动刷新；未保存、语法错或未首次触发均导致预览失效。
Sublime Text 本身不渲染 Markdown，所谓“实时预览”是靠 MarkdownPreview 插件 + 浏览器配合模拟出来的效果；没手动触发首次预览、语法没设对、插件装完没重启，这三步错一步，预览就卡死。
怎么确认当前文件被识别为 Markdown？
右下角状态栏显示什么，Sublime 就按什么语法处理——哪怕文件名是 readme.md，如果那里写着 Plain text，MarkdownPreview 就完全不响应任何命令。
- 点击右下角文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 想一劳永逸？打开一个
.md文件后，右下角点击 →Open all with current extension as…→Markdown - 未保存的临时文件（如
untitled）永远无法触发预览，务必先Ctrl+S保存为.md后缀
装了 MarkdownPreview 却找不到命令？
常见原因不是插件没装好，而是 Sublime 没重启，或装了冲突插件（比如同时有 OmniMarkupPreviewer 或旧版 Markdown Preview）。
- 安装完
MarkdownPreview后必须完全退出 Sublime 再重开，否则Ctrl+Shift+P里搜不到命令 - 用
Ctrl+`打开控制台，输入import sys; print(sys.version)，确认输出 Python 版本 ≥3.3（ST4 自带 3.8+，无需额外装 Python） - 别碰
enable_autoreload：该配置项已在新版MarkdownPreview中废弃，强行写入会导致自动刷新失效
为什么保存后浏览器不自动刷新？
它不是“保存就刷新”，而是“先手动执行一次 Markdown Preview: Preview in Browser，之后保存才触发刷新”——这个前提漏掉，所有配置都白搭。
- 首次必须手动执行：
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车 - 浏览器会以
file://协议打开 HTML 页面；若 URL 是http://localhost:xxxx或含中文路径，自动刷新大概率失败 - 刷新依赖浏览器原生能力，不用装
LiveReload扩展，也不用改mathjax_enabled等参数来启用基础刷新
图片路径不显示？别怪插件，先看相对路径怎么算
MarkdownPreview 渲染时，图片路径是相对于当前 .md 文件所在目录解析的，不是相对于项目根目录或 Sublime 工作目录。
- 错误写法：
—— 若文件在/docs/intro.md，则实际查找路径是/docs/images/logo.png - 正确写法示例：
或，确保路径能从.md文件位置出发抵达资源 - 若图片仍不显示，打开浏览器开发者工具（
F12），看Network标签页里请求是否 404
真正容易被忽略的是：预览页必须保持打开且未被浏览器强制关闭（比如 Chrome 的后台页面休眠策略），否则下次保存时脚本已断连，刷新就静默失败。这不是插件问题，是浏览器行为，得自己盯住那个标签页。
