必须安装 markdownpreview 插件，文件需设为纯 markdown 语法并保存为 .md 后缀，首次手动运行 preview in browser 后保存才自动刷新；enable_autoreload 已废弃，设为 true 反致卡死。
装对插件：只认 MarkdownPreview，别碰 OmniMarkupPreviewer 或 MarkdownEditing
很多人搜“markdown preview”装错插件，点命令面板里的名字却没反应——真正起作用的只有 MarkdownPreview（结尾是 Preview，不是 Previewer，不带空格、不加 s）。MarkdownEditing 只负责语法高亮和快捷键，完全不生成 HTML；OmniMarkupPreviewer 已多年未维护，在 ST4 上常导致右键菜单消失或快捷键冲突。安装必须用 Package Control：按 Ctrl+Shift+P → 输入 Package Control: Install Package → 粘贴 MarkdownPreview（注意大小写和拼写），回车。输 markdown preview（带空格）搜不到。
文件必须被识别为 Markdown 语法，不是靠文件名
哪怕你打开的是 readme.md，只要右下角状态栏显示 Plain text，MarkdownPreview 就彻底静默。这不是 bug，是设计逻辑：Sublime 按当前语法类型决定是否触发预览。点击右下角文字 → 搜索 Markdown → 选中纯 Markdown（不是 Markdown GFM 或其他变体）。想一劳永逸？保存后右下角点击 → Open all with current extension as… → Markdown。未保存的临时文件（如 untitled）永远无法触发预览，务必先 Ctrl+S 保存为 .md 后缀。
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
首次必须手动触发 Markdown Preview: Preview in Browser
所谓“实时刷新”其实是伪实时：它依赖浏览器标签页保持打开 + 首次手动触发 + 文件保存事件监听三者协同。跳过任意一环，预览就卡死或空白。操作路径：按 Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser → 回车。浏览器会以 file:// 协议打开 HTML 页面；若 URL 是 http://localhost:xxxx 或含中文路径，自动刷新大概率失败。之后每次保存，只要该标签页没关，就会自动 reload —— 这个前提漏掉，所有配置都白搭。
enable_autoreload 在新版里已废弃，设为 true 反而卡死
很多老教程说加 "enable_autoreload": true 就能“实时”，这是过时信息。2026 年起该配置项已被移除：设为 true 会导致 Sublime 在保存瞬间卡住，甚至崩溃（尤其 ST4 + Windows）。真正起作用的是浏览器端原生 reload 能力，无需额外装 LiveReload 扩展，也不用改 mathjax_enabled 等参数来启用基础刷新。如果已在 Settings – User 里写了这行，删掉它。刷新是否生效，只取决于：是否首次手动打开了预览页、URL 是否为 file:// 或 http://127.0.0.1: 开头、浏览器是否阻止了本地脚本执行（Safari 默认拦截 file://，换 Chrome 或 Edge 更稳）。
