Sublime Text 本身不渲染 Markdown,所谓“实时预览”需依赖持续维护的 MarkdownPreview 插件生成 HTML 并通过浏览器自动重载实现,首次必须手动触发 Preview in Browser 命令,之后保存才可能刷新;不支持侧边内嵌预览,且 enable_autoreload 配置在 2026 年已废弃,启用会导致卡死或崩溃。

Sublime Text 本身不渲染 Markdown,所谓“实时预览”只是靠 MarkdownPreview 插件生成 HTML + 浏览器自动重载模拟出来的效果;它不支持侧边内嵌预览,也不原生监听文件变化——首次必须手动触发 Markdown Preview: Preview in Browser,之后保存才可能刷新。
装哪个插件?只认 MarkdownPreview,别碰其他名字相近的
现在唯一持续维护、兼容 Sublime Text 4、自带数学公式基础支持、且不和主流插件冲突的只有 MarkdownPreview(注意结尾是 Preview,不是 Preview 带空格,也不是 MarkdownEditing 或已停更多年的 OmniMarkupPreviewer)。
-
MarkdownEditing可以装,但它只管语法高亮和快捷键,不负责预览;和MarkdownPreview是互补关系,不是替代关系 -
MarkdownLivePreview已多年未更新,2026 年起在 ST4 下大概率报错或无法启动本地服务 - 装错插件会导致右键菜单消失、
Ctrl+Shift+P搜不到命令、甚至快捷键失效
Markdown Preview: Preview in Browser 没反应?先看这三点
命令面板能搜到但点了没反应,或者菜单灰掉,基本不是插件坏了,而是运行前提没满足:
- 文件必须已保存,且后缀是
.md或.markdown;新建未存的 tab 插件直接忽略 - 右下角状态栏必须显示
Markdown(推荐选Markdown (GitHub flavored)),不是Plain text;点它 →Set Syntax→ 手动切过去 - 编码必须是
UTF-8:含中文路径或内容时,若为GBK等编码,预览页会空白或报错;File → Reopen with Encoding → UTF-8再试
为什么保存后浏览器不自动刷新?enable_autoreload 已废弃,别再配了
2026 年起,"enable_autoreload": true 在用户配置中不仅无效,还会导致 Sublime 在保存瞬间卡死甚至崩溃(尤其 Windows + ST4)。真正的自动刷新机制是:
- 首次必须手动执行一次
Markdown Preview: Preview in Browser,生成 HTML 并打开浏览器标签页 - 之后只要保持该标签页开着,且 URL 是
file://或http://127.0.0.1:开头,保存即刷新 - Chrome 用户若启用了“严格隔离”或“阻止第三方 Cookie”,可能导致重载脚本加载失败;可临时换 Edge/Firefox 测试,或关闭对应策略
图片不显示?路径解析规则和你想象的不一样
MarkdownPreview 解析图片路径时,基准目录永远是 .md 文件所在目录,不是项目根目录,也不是 Sublime 工作目录:
- 错误写法:
—— 若文件在/docs/intro.md,它实际找的是/docs/images/logo.png - 正确写法示例:
或,确保路径从.md文件位置出发能抵达资源 - 不确定路径对不对?打开浏览器开发者工具(
F12),看Network标签里图片请求的Status和URL
真正容易被忽略的点是:首次手动预览那一下不能跳过,也没有替代方案;所有“保存即刷新”的效果都建立在这个动作之上。很多人反复改配置、重装插件,却漏掉了右下角那个小小的 Markdown 标识是否真的生效。


















