Sublime如何实时预览Markdown_Sublime插件文档同步显示技巧【案例】
SublimeText不支持Markdown实时预览,需用MarkdownPreview插件配合浏览器,设置`"enable_autoreload":true`并首次手动预览即可自动刷新。也可用LiveReloadCLI加浏览器扩展,注意端口占用、路径中文及语法设置等问题。
先泼盆冷水:Sublime Text 天生就不支持 Markdown 实时预览。想要边写边看效果?那得靠 MarkdownPreview 插件加浏览器来打配合。而很多人在这一环节就栽了——装错插件、配置没开对、文件路径带中文、或者忘了先手动触发一次预览。实话实说,九成的失败案例,都卡在这几个坑里。

好了,接下来我们一个一个拆解。
为什么装了 MarkdownPreview 还不能自动刷新?
很多人以为装上插件就能“实时”,其实不然。MarkdownPreview 默认工作在手动模式下:你需要手动执行一次 Markdown Preview: Preview in Browser,它才会生成 HTML 并弹出浏览器窗口。之后你改完文件、点保存,页面纹丝不动。
所谓的“实时”,其实是通过配置 "enable_autoreload": true,让插件在保存文件后向已经打开的浏览器标签页发送刷新指令。这个功能有几个硬性前提:
- 必须先手动执行一次预览——否则根本没有目标标签页可以接收刷新信号。
- 浏览器必须通过
file://或http://127.0.0.1打开。用http://localhost有时会因为端口冲突而失败。 - Chrome 或 Edge 需要关闭“使用预测服务来加载网页”这个设置(在
chrome://settings/privacy里找),否则本地文件的刷新请求经常被拦截。 - 在 macOS 上用 Safari 搭配
"enable_autoreload": true容易失焦——页面不会自动刷新。建议固定使用 Chrome,并在配置中指定"browser": "chrome"。
LiveReload 插件到底有没有用?
坦白说,Sublime 里那些叫 LiveReload 的插件,绝大多数没什么用。它们要么只适配 Sublime Text 3,要么压根就没注入真正的刷新逻辑。真正能起效的方案是独立运行的 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的报错,说明端口被占了。macOS/Linux 下用lsof -i :35729,Windows 下用netstat -ano | findstr :35729查一下是谁在占用这个端口。
预览空白、公式不渲染、表格错位怎么办?
这些问题通常不是插件坏了,而是解析器和扩展配置没对齐。
- 文件后缀名必须是
.md,而不是.markdown或.txt。确认 Sublime Text 右下角状态栏显示的是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——结果绕了一大圈,全是白忙。


































