Sublime Text 本身不支持 Markdown 实时预览,必须依赖持续维护的 MarkdownPreview 插件配合浏览器实现伪实时效果;需确保语法识别为 Markdown、文件已保存且编码为 UTF-8、首次手动触发预览,并配合 LiveReload 扩展或自定义配置才能保存即刷新。

Sublime Text 本身不支持 Markdown 实时预览
别指望 Ctrl+S 保存后浏览器自动跳转新内容——Sublime 没内置渲染引擎,所有“实时”都是靠插件模拟出来的。真正能用、持续维护、适配 Sublime Text 4 的只有 MarkdownPreview,不是 Markdown Preview(带空格)、OmniMarkupPreviewer 或 MarkdownEditing。后三者要么已停更,要么只做语法高亮,装了反而可能让右键菜单消失或 Ctrl+Alt+M 快捷键失效。
安装后必须重启 + 确认语法识别为 Markdown
装完 MarkdownPreview 不重启,命令面板里搜不到 Markdown Preview: Preview in Browser;即使重启了,如果右下角状态栏显示的是 Plain text 而不是 Markdown,插件压根不干活。解决方法很简单:
- 打开一个
.md文件 - 点击右下角语言标识 → 选
Markdown(不是Markdown GFM或其它变体) - 确保文件已保存:新建未存的 tab,插件直接忽略
- 检查编码:含中文路径或内容时,
File → Reopen with Encoding → UTF-8,否则预览空白或报错
“自动刷新”不是开个配置就完事
在 Preferences → Package Settings → Markdown Preview → Settings – User 里加 "enable_autoreload": true,只是让插件开始监听文件变化——它不会让浏览器自己刷新。要真看到“保存即更新”,得三步齐备:
- 首次必须手动执行一次
Markdown Preview: Preview in Browser,之后保存才触发监听 - Chrome / Edge 用户需安装 LiveReload 扩展(非插件),并启用
Simple Reload with delay (400ms) - Firefox 用户得手动注入 LiveReload 脚本,或改用
http-server配合自定义模板
另外,数学公式和 Mermaid 图表默认关闭,要支持得单独加 "enable_math": true 和 "enable_mermaid": true,且 Mermaid 依赖浏览器端 JS 加载,本地 file:// 协议下大概率失败。
快捷键和导出行为容易被忽略的细节
Ctrl+Alt+M(Windows/Linux)默认只在 text.html.markdown 作用域生效,如果语法没切对,按键完全没反应。想换快捷键或绑定到所有文本,得进 Preferences → Key Bindings 手动加:
{"keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
导出 HTML 到 Sublime 标签页(Export HTML in Sublime Text)和复制 HTML(Copy to Clipboard)不走浏览器流程,也不依赖 LiveReload,但生成的 HTML 默认带内联样式,没法直接嵌入现有网站;若要定制外观,得配 "html_template" 指向绝对路径的 HTML 文件,并设 "skip_default_stylesheet": true。
最常被卡住的地方是:以为“装了插件=实时”,结果第一次预览失败就放弃;其实只要确认语法识别、UTF-8 编码、首次手动触发这三点,后续流程就稳了。LiveReload 那套只是锦上添花,不是必选项。


















