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 推送。想“所见即所得”，得换工具链，而不是调参数。

# css  # windows  # git  # markdown  # js  # sublime  # html  # python  # linux  # github