markdownPreview插件安装及使用问题需分步排查:先确保Package Control正常,再正确关联.md文件语法、配置扩展支持GFM特性,手动触发预览,理解其无自动刷新机制。

MarkdownPreview 插件装不上?先确认 sublime 的包管理器是否正常
很多用户卡在第一步:按 Ctrl+Shift+P(windows/linux)或 Cmd+Shift+P(macos)调出命令面板后,搜不到 Package Control: Install Package。这说明 Package Control 没装好或已损坏。
- 去 packagecontrol.io 复制对应 Sublime 版本(sublime text 3 或 4)的安装代码,粘贴进 Sublime 的 python 控制台(
Ctrl+`)执行 - 重启 Sublime,再试
Ctrl+Shift+P→ 输入Install Package,回车 - 如果仍无响应,检查是否禁用了自动更新或被公司网络拦截了
https://packagecontrol.io
安装 MarkdownPreview 后预览没反应?检查文件关联和构建系统
插件装完不代表自动生效。Sublime 不会默认把 .md 文件当成 Markdown 处理,也不会自动绑定预览快捷键。
- 打开一个
.md文件,右下角状态栏点击当前语法类型(如Plain Text),选Markdown→ 这步让 Sublime 正确解析语法高亮和插件触发条件 - 确保文件已保存为真实路径下的
.md文件(未保存的临时文件可能无法触发预览) - 默认快捷键是
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser回车;也可手动设快捷键,在Preferences → Key Bindings中添加:
[ { "keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"} } ]
预览内容乱码、样式空白或不渲染表格/TOC?调整插件配置
默认配置用的是内置的简易 Markdown 解析器,不支持 gitHub Flavored Markdown(GFM)特性,也不加载 css 样式。
- 进入
Preferences → Package Settings → Markdown Preview → Settings - 在右侧用户配置中覆盖关键项:
{ "enabled_extensions": ["extra", "codehilite", "toc", "fenced_code", "tables"], "markdown_extensions": { "extra": {}, "codehilite": {"css_class": "highlight"}, "toc": {"permalink": true}, "tables": {}, "fenced_code": {} }, "include_css": true, "enable_highlight": true }
为什么改了文件内容,浏览器预览不自动刷新?这不是插件问题
MarkdownPreview 本身不提供实时刷新(Live Reload)功能,这是有意设计:避免频繁写入磁盘或触发浏览器重绘影响编辑体验。
- 每次修改后需手动触发预览(快捷键或命令面板),或使用第三方工具配合,比如:
BrowserSync+ 自定义构建系统 - 更轻量的替代方案:用 VS Code 的
Markdown Preview Enhanced,或直接开一个本地服务(python3 -m http.server 8000)配合文件监听脚本 - 注意:不要在配置里误开
"auto_reload_on_save"—— 这个选项并不存在,是常见误解
最常被忽略的一点:插件生成的 html 是一次性快照,不是 websocket 推送。想“所见即所得”,得换工具链,而不是调参数。