MarkdownPreview 插件自2026年起已废弃 enable_autoreload 配置，启用会导致卡死或崩溃；真正有效的热重载需首次手动预览 + 浏览器 LiveReload 扩展配合，且须确保 file:// 协议、正确路径解析及中文锚点解码。
Sublime Text 的 MarkdownPreview 插件本身不支持真正的热重载，所谓“自动刷新”必须手动触发首次预览后才生效，且新版（2026年起）已废弃 enable_autoreload 配置项——设为 true 反而会导致保存卡死或崩溃。
为什么 enable_autoreload 不该再用
该配置项在 2026 年起的 MarkdownPreview 版本中已被移除逻辑支持。即使你强行写入 "enable_autoreload": true 到 MarkdownPreview.sublime-settings，它不会启用轮询或 WebSocket，只会让插件在保存瞬间尝试注入无效脚本，引发：
- Windows + ST4 下 Sublime 卡顿甚至无响应
- 浏览器控制台报错
Failed to load resource: net::ERR_FILE_NOT_FOUND（指向一个不存在的livereload.js） - 预览页 URL 从
file://...被悄悄替换成about:blank，导致后续所有刷新失效
真正起作用的是“首次预览 + 浏览器 LiveReload 扩展”组合
自动刷新依赖两个不可省略的前提：
- 必须先手动执行一次
Markdown Preview: Preview in Browser（快捷键：Ctrl+Shift+P → 输入并回车），生成初始 HTML 页面并打开标签页 - 该标签页必须是
file://协议（如file:///C:/project/readme.html），不能是http://localhost（端口冲突常见） - Chrome/Edge 用户需关闭
chrome://settings/privacy中的「使用预测服务来加载网页」，否则本地文件刷新被拦截 - 浏览器必须安装对应 LiveReload 扩展，并点击图标启用（实心绿色圆点）
LiveReload 插件配置要点（替代方案）
若你坚持要稳定热重载，应弃用 MarkdownPreview 的内置刷新机制，改用独立的 LiveReload 插件监听文件变化：
- 安装
LiveReload插件后，在Preferences → Package Settings → LiveReload → Settings – User中写入：{ "enabled_plugins": ["SimpleReloadPlugin"], "simple_reload_delay": 300 } - 在项目根目录右键 →
Enable Plugin: Simple Reload，状态栏出现 LiveReload 图标即表示监听已启动 - 确保浏览器 LiveReload 扩展已激活，且当前标签页 URL 是
file://或http://127.0.0.1:xxxx（推荐用browser-sync启服务，绕过 file:// 跨域限制） - 不要同时启用 MarkdownPreview 的
enable_autoreload和 LiveReload —— 二者冲突，会互相覆盖 reload 脚本注入时机
图片和锚点路径失效？不是重载问题，是解析上下文错了
热重载能刷出页面，但刷出来却是空白图或点不动的中文锚点，原因与重载无关：
- 图片路径始终相对于
.md文件所在目录解析，意味着文件必须在同级img/文件夹下；用开发者工具 Network 面板查 404 请求路径，一眼定位错在哪 - 中文标题锚点（如
[简介](#简介)）失效，是因为默认不进行 URL 解码；需在 MarkdownPreview 配置中显式添加："html_preview": true, "enable_highlight": true
（后者会顺带激活 UTF-8 锚点解码） - 中文路径下保存预览失败？别折腾编码，直接把
.md文件移到纯英文路径（如D:/md/），验证是否为系统层 URL 转义缺陷
最常被忽略的一点：所有自动刷新行为，只对「已打开的预览标签页」生效。新开标签页、复制链接、用书签访问，都不会继承重载能力——你得重新触发一次 Preview in Browser。
