Sublime Text 需通过 Markdown Preview 与 LiveReload 插件组合实现 Markdown 实时预览,但二者默认不联动;须手动配置 LiveReload 监听 .md 文件并调用 markdown_preview 命令,且浏览器需安装并启用官方 LiveReload 扩展。

Sublime Text 本身不支持 Markdown 实时预览,也没有内置 LiveReload 功能;必须通过插件组合实现——但直接装 Markdown Preview + LiveReload 插件会失败,因为二者默认不联动。
装对插件:Markdown Preview 是核心,LiveReload 是辅助
Markdown Preview 负责把 .md 文件转成 HTML 并打开浏览器预览;LiveReload 只负责监听文件变化并触发浏览器刷新——但它**不生成 HTML**,也不会自动调用 Markdown Preview 的构建流程。
- 必须先通过
Package Control安装Markdown Preview(不是MarkdownEditing) -
LiveReload插件要装官方版:LiveReload(作者是 dwb95),不是同名的其他 fork 版本 - 不要装
Markdown Live Preview这类已弃用/不维护的插件,它们在 Sublime 4 下基本不可用
手动绑定 LiveReload 到 Markdown 构建结果
LiveReload 默认只监听 .html、.css 等静态文件,对 .md 文件无反应。需要让它“假装”自己在监听一个 HTML 文件——而这个 HTML 正是由 Markdown Preview 生成并写入临时目录的。
-
Markdown Preview默认把渲染结果写到cache目录,路径类似:~/Library/Caches/Sublime Text/Cache/Markdown Preview/xxx.html(macOS)或%LOCALAPPDATA%\Sublime Text\Cache\Markdown Preview\*.html(Windows) - 在 Sublime 中打开
Preferences → Package Settings → LiveReload → Settings – User,填入:
{
"enabled_plugins": ["SimpleReloadPlugin"],
"SimpleReloadPlugin": {
"paths": ["*.md"],
"command": "markdown_preview",
"args": {"target": "browser", "parser": "markdown"}
}
}
⚠️ 注意:"command" 必须是 "markdown_preview"(小写+下划线),不是 "MarkdownPreview" 或其他变体;"target": "browser" 才能确保输出 HTML 并触发刷新。
浏览器端必须手动启用 LiveReload 插件
Sublime 里的 LiveReload 插件只是“服务端”,浏览器里还得有对应客户端才能接收信号。Chrome 用户必须安装官方 LiveReload 扩展(Chrome Web Store 搜索即可),Firefox 同理。
- 扩展图标亮起(绿色)表示已连接;灰色代表未连接或端口被占
- 首次使用时,浏览器可能弹出“是否允许该扩展访问本地文件”,必须点“允许”,否则无法响应 Sublime 的刷新请求
- 如果预览页面是
file://协议(即直接双击打开 HTML),LiveReload 扩展默认禁用——此时需改用http://localhost:xxxx方式访问,或在扩展设置中勾选Allow access to file URLs
替代方案更轻量:用 Python HTTP 服务 + 浏览器自动刷新
如果你只是想边写边看,不强求“保存即刷新”,其实不用折腾 LiveReload。用 Markdown Preview 的 Copy to Clipboard 或 Save to File 功能,配合 Python 自带的 HTTP 服务,更稳定:
- 用
Markdown Preview的命令面板(Ctrl+Shift+P/Cmd+Shift+P)运行Markdown Preview: Save to File,它会把当前 md 渲染为同名.html存在项目目录下 - 终端进入该目录,执行:
python -m http.server 8000(Python 3)或python -m SimpleHTTPServer 8000(Python 2) - 浏览器打开
http://localhost:8000/xxx.html,再配合浏览器插件如Auto Refresh Plus(Chrome)设为 1 秒刷新一次,效果更可控
LiveReload 的同步链路太长(md → cache html → lr server → browser lr client → reload),任一环节出问题都卡住;而手动 save + 静态服务的方式,每个步骤可验证、无隐式依赖。










