MarkdownPreview插件名必须严格为MarkdownPreview（无空格、无s、非Previewer），装错插件是预览失败主因；文件须被识别为Markdown语法（右下角显示Markdown）、已保存为.md后缀，且首次需手动触发Preview in Browser，之后保存才自动刷新；禁用已废弃的"enable_autoreload": true配置。
MarkdownPreview插件名拼写必须严格匹配
装错插件是预览失败的第一大原因。命令面板里能看到Markdown Preview: Preview in Browser但点了没反应，大概率是因为装了名字相近的假插件：MarkdownEditing只管语法高亮，OmniMarkupPreviewer早已停止维护且与 ST4 冲突严重。唯一有效的是 MarkdownPreview（结尾是 Preview，无空格、无 s、不是 Previewer 或 LivePreview）。用 Package Control 安装时，必须在输入框里完整敲入 MarkdownPreview，输 markdown preview（带空格）搜不到。
文件语法识别比文件名更重要
哪怕你打开的是 readme.md，只要右下角状态栏显示 Plain text，MarkdownPreview 就完全静默——这不是 bug，是设计逻辑。它只响应被 Sublime 识别为 text.html.markdown 作用域的文件。
- 点击右下角状态栏文字 → 搜索
Markdown→ 选中纯Markdown（不是Markdown GFM或其他变体） - 未保存的临时 tab（如
untitled）永远无法触发预览，必须先Ctrl+S保存为.md后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown -
Ctrl+Alt+M快捷键默认只在text.html.markdown作用域生效，语法不对，快捷键等于不存在
首次手动预览是自动刷新的前提
所谓“实时联调”本质是伪实时：它依赖浏览器标签页保持打开 + 首次手动触发 + 文件保存事件监听三者协同。跳过任意一环，后续所有配置都无效。
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
- 必须先按
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车执行一次 - 之后每次保存，只要该浏览器标签页没关，且 URL 是
file://或http://127.0.0.1开头，就会自动 reload -
http://localhost有时因端口冲突失败，优先用file://协议 - Chrome / Edge 若启用了“阻止第三方 Cookie”或“严格隔离”，reload 脚本可能加载失败；可临时禁用，或换 Firefox 测试
别再设 "enable_autoreload": true
这是 2026 年起已被废弃的配置项。强行写入不仅无效，还会导致 Sublime 在保存瞬间卡住甚至崩溃（尤其 ST4 + Windows）。新版 MarkdownPreview 的自动刷新能力完全由浏览器端原生 reload 脚本驱动，不依赖任何插件侧开关。
- 如果你已在
Settings – User里写了这行，立刻删掉它 - 真正影响刷新是否生效的只有三件事：是否首次手动打开了预览页、URL 是否为
file://或http://127.0.0.1、浏览器是否允许本地脚本执行 - Safari 默认拦截
file://协议下的 JS 执行，换 Chrome 或 Edge 更稳
最易被忽略的点是：预览页 URL 必须以 file:// 开头，且不能含中文路径——哪怕只是文件夹名含中文，也会导致 reload 失效。调试时先用纯英文路径测试，确认流程通了再迁移回工作目录。
