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
}
-
"include_css": true是关键——它让插件注入默认样式表；若关了，网页就是纯白底黑字 - 如需自定义样式，可修改
css/js路径，但注意路径必须是绝对路径或相对于插件目录的相对路径
为什么改了文件内容，浏览器预览不自动刷新？这不是插件问题
MarkdownPreview 本身不提供实时刷新（Live Reload）功能，这是有意设计：避免频繁写入磁盘或触发浏览器重绘影响编辑体验。
- 每次修改后需手动触发预览（快捷键或命令面板），或使用第三方工具配合，比如：
BrowserSync+ 自定义构建系统 - 更轻量的替代方案：用 VS Code 的
Markdown Preview Enhanced，或直接开一个本地服务（python3 -m http.server 8000）配合文件监听脚本 - 注意：不要在配置里误开
"auto_reload_on_save"—— 这个选项并不存在，是常见误解
最常被忽略的一点：插件生成的 HTML 是一次性快照，不是 WebSocket 推送。想“所见即所得”，得换工具链，而不是调参数。
