Sublime如何实时预览Markdown_Sublime插件文档同步显示技巧【案例】

先泼盆冷水：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——结果绕了一大圈，全是白忙。