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 覆盖，它不走 <link> 加载。
