sublime怎么配置Markdown实时预览_sublime安装LiveReload同步【教程】

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 TextCacheMarkdown 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 + 静态服务的方式，每个步骤可验证、无隐式依赖。