
Sublime Text 需通过 MarkdownPreview 插件实现稳定离线 Markdown 预览;推荐用 Package Control 安装,配置 UTF-8 编码、启用 html_template 和中文字体,并绑定 Ctrl+Alt+M 快捷键手动触发浏览器预览。
Sublime Text 本身不内置 Markdown 实时预览,必须靠插件实现;最稳定、轻量、可离线用的方案是 MarkdownPreview,不是 OmniMarkupPreviewer(已停止维护且兼容性差)。
推荐用 Package Control 安装,避免手动出错:
Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),调出命令面板Package Control: Install Package,回车MarkdownPreview,选中并回车安装注意:不要搜 “Markdown Preview”(少一个 r)——那是另一个不维护的老插件,会报 KeyError: 'mdpopups' 错误。
默认绑定的快捷键是 Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser,但更高效的是直接设快捷键:
Preferences → Key Bindings
[
{ "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")。
Sublime 的文件系统事件监听在某些场景(如网络盘、WSL、Docker mount)不可靠,MarkdownPreview 的“手动触发 + 浏览器 F5 刷新”反而是最稳的组合:
Markdown Preview: Save to HTML)时,依赖同一套渲染逻辑,保证预览与交付一致真正容易被忽略的是:预览页的 CSS 是硬编码在插件 Python 文件里的(mdpreview.py 中的 DEFAULT_CSS),改样式要动源码——别指望通过外部 CSS 覆盖,它不走 加载。