Sublime如何实现Markdown文档的实时预览？ (Markdown Preview插件)

安装markdown Preview后预览无反应，主因是语法未设为Markdown或快捷键未绑定；它不支持实时刷新，需手动触发预览；样式问题多因parser选择不当或Pygments未启用；windows双击打开失败常因文件关联或焦点问题。

安装 Markdown Preview 插件后预览没反应？

多数情况是插件未正确绑定到 Markdown 语法模式，或快捷键冲突。sublime 默认不会自动为 .md 文件启用该插件的预览功能，需手动确认语法高亮是否为 Markdown（右下角状态栏应显示 Markdown，而非 Plain Text）。若显示错误，先通过 Ctrl+Shift+P → 输入 Set Syntax: Markdown 手动设置。

如何触发实时预览？它其实不“实时”

Markdown Preview 本身不提供真正的实时刷新（即保存即更新），而是按需生成 html 并在浏览器中打开。常用方式有：

• Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser 执行一次预览
• 绑定快捷键：在 Preferences → Key Bindings 中添加如下条目（注意路径和平台差异）：

  [     { "keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"} } ]

• 想“类实时”，可配合 auto Save 插件 + 上述快捷键 + 浏览器刷新（部分浏览器如 chrome 需装 Refresh Page 扩展才能热重载）

预览样式丑、代码块无高亮？检查 parser 和 css 配置

默认 parser 是 markdown（即 python-Markdown），不支持 Mermaid、数学公式或高级代码高亮。若需更好渲染效果：

• 改用 github parser：在命令参数中设 "parser": "github"，但要求网络通畅且依赖 GitHub API（离线不可用）
• 启用 Pygments：确保已安装 pygments（pip install pygments），并在插件设置里开启 "enable_pygments": true
• 自定义 CSS：修改 MarkdownPreview.sublime-settings 中的 "css": [".../my-style.css"]，路径必须为 Sublime 内部资源路径（如 Packages/User/markdown.css）

Windows 下双击打开 .md 文件预览失败？

常见于系统关联了其他编辑器（如 Typora），导致 Sublime 没获得文件焦点；或插件监听的 on_post_save 事件未触发（比如文件被外部程序修改后保存）。更稳妥的做法是：

• 始终在 Sublime 内用 File → Open 打开文档，避免双击绕过 Sublime 的语法识别流程
• 确认插件设置中 "enable_autoreload": false（该选项实际已废弃，设为 true 反而常引发异常）
• 如果使用 WSL 或远程文件，避免直接编辑挂载路径下的 .md，Sublime 可能无法捕获文件系统事件

真正卡住的地方往往不是插件装没装，而是语法识别没到位、parser 选错、或者以为“实时”却忘了手动触发——它本质是个静态快照工具，别把它当 Obsidian 用。