Sublime如何使用Markdown插件 Sublime撰写文档实时预览【神器】

sublime Text 需通过 markdownPreview 插件实现稳定离线 Markdown 预览；推荐用 Package Control 安装，配置 UTF-8 编码、启用 html_template 和中文字体，并绑定 Ctrl+Alt+M 快捷键手动触发浏览器预览。

sublime text 本身不内置 Markdown 实时预览，必须靠插件实现；最稳定、轻量、可离线用的方案是 MarkdownPreview，不是 OmniMarkupPreviewer（已停止维护且兼容性差）。

安装 MarkdownPreview 插件

推荐用 Package Control 安装，避免手动出错：

• 按 Ctrl+Shift+P（windows/linux）或 Cmd+Shift+P（macos），调出命令面板
• 输入 Package Control: Install Package，回车
• 搜索 MarkdownPreview，选中并回车安装
• 安装完成后，重启 Sublime（部分版本需重启才加载成功）

注意：不要搜 “Markdown Preview”（少一个 r）——那是另一个不维护的老插件，会报 KeyError: 'mdpopups' 错误。

用快捷键触发实时 HTML 预览

默认绑定的快捷键是 Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser，但更高效的是直接设快捷键：

• 菜单栏选 Preferences → Key Bindings
• 在右侧用户键绑定中添加（支持 Windows/macOS/Linux）：

[     { "keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"} } ]

保存后，打开任意 .md 文件，按 Ctrl+Alt+M 就能在浏览器中打开预览页。刷新页面即可同步最新编辑内容（无需插件自动监听，手动触发更可控）。

解决中文乱码和样式难看问题

默认预览常出现中文方块、无 css、字体小——这不是插件坏了，而是没配好解析器和模板：

• 确保文件编码是 UTF-8（右下角状态栏查看，点开可切换）
• 在 Preferences → Package Settings → Markdown Preview → Settings 中，修改以下关键项：

{     "enable_highlight": true,     "enable_mathjax": false,     "html_template": true,     "github_mode": "gfm",     "parser": "markdown" }

"html_template": true 启用自带 HTML 模板（含基础 CSS 和中文字体声明），比纯裸 Markdown 输出可读性强得多；若仍乱码，检查系统是否缺失思源黑体等开源中文字体（font-family 默认含 "Source Han Sans SC"）。

为什么不用 LiveReload 或自动刷新？

Sublime 的文件系统事件监听在某些场景（如网络盘、WSL、docker mount）不可靠，MarkdownPreview 的“手动触发 + 浏览器 F5 刷新”反而是最稳的组合：

• 自动监听可能漏更新，尤其快速连敲时
• LiveReload 需额外装浏览器插件和本地服务，增加故障点
• 导出静态 HTML（Markdown Preview: Save to HTML）时，依赖同一套渲染逻辑，保证预览与交付一致

真正容易被忽略的是：预览页的 CSS 是硬编码在插件 python 文件里的（mdpreview.py 中的 DEFAULT_CSS），改样式要动源码——别指望通过外部 CSS 覆盖，它不走 加载。