Sublime Text 本身不支持 Markdown 实时预览,必须通过 MarkdownPreview 插件配合浏览器实现;默认为手动模式,需先手动执行一次“Preview in Browser”,再配置 "enable_autoreload": true 并确保浏览器以 file:// 或 http://127.0.0.1 打开,才能实现保存后自动刷新。

Sublime Text 本身不支持 Markdown 实时预览,所谓“实时”必须靠 MarkdownPreview 插件 + 浏览器配合实现;装错插件、开错配置、路径含中文或没手动触发首次预览,90% 的失败都发生在这几步。
为什么装了 MarkdownPreview 还不能自动刷新?
MarkdownPreview 默认是手动模式:你按一次 Markdown Preview: Preview in Browser,它才生成 HTML 并打开浏览器;之后改文件、保存,页面不会自己动。所谓“实时”,其实是靠配置 "enable_autoreload": true 让插件在保存后向已打开的浏览器标签页发刷新指令——但这个功能有硬性前提:
- 必须先手动执行一次预览(否则没有目标标签页可刷新)
- 浏览器必须用
file://或http://127.0.0.1打开,http://localhost有时会因端口冲突失败 - Chrome/Edge 要关掉
chrome://settings/privacy里的“使用预测服务来加载网页”,否则本地文件刷新常被拦截 -
"enable_autoreload": true在 macOS 上搭配 Safari 容易失焦,建议固定用 Chrome 并配"browser": "chrome"
LiveReload 插件到底起不起作用?
Sublime 里装任何叫 LiveReload 的插件基本没用——它们要么只适配 ST3、要么根本没注入刷新逻辑。真正起效的是独立运行的 livereload CLI 命令 + 浏览器扩展组合:
基于三引擎设计,从微信文章、新闻和博客网页提取干净内容,支持标题作者日期元数据,多格式和批量处理。
- 先装 CLI:
npm install -g livereload - 项目根目录运行:
livereload . --port 35729 --exts html,css,js,md(漏掉md就不会响应 Markdown 修改) - 浏览器必须装官方 LiveReload 扩展(图标是黑白靶心),且右下角显示
LiveReload is connected - 网页必须用
http://localhost:35729打开,file://协议下扩展被禁用,连不上 WebSocket - 如果控制台报
WebSocket connection to 'ws://localhost:35729/livereload' failed,先用lsof -i :35729(macOS/Linux)或netstat -ano | findstr :35729(Windows)查端口是否被占
预览空白、公式不渲染、表格错位怎么办?
这些不是插件坏了,而是解析器和扩展没对齐:
- 文件后缀必须是
.md(不是.markdown或.txt),且右下角状态栏显示Markdown语法(点一下手动切过去) - 数学公式要生效,得在
MarkdownPreview.sublime-settings里加"enable_math": true,且确保没开"parser": "github"(GitHub API 离线不可用) - 表格、代码块高亮依赖
Pygments,需系统级安装:pip install pygments,再配"enable_pygments": true - 路径含中文或空格时,Chrome 可能打不开
file://页面,此时应改用http-server起临时服务:npx http-server -c-1,然后访问http://127.0.0.1:8080 - 别同时装
MarkdownPreview和OmniMarkupPreviewer,二者冲突会导致快捷键失效、右键菜单消失
最常被忽略的一点:所有“实时”效果都建立在「首次预览成功」的基础上。很多人卡在第一步——没手动执行过 Markdown Preview: Preview in Browser,就去调配置、装扩展、改端口,结果全是白忙。

















