安装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、数学公式或高级代码高亮。若需更好渲染效果:
- 改用
githubparser:在命令参数中设"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 可能无法捕获文件系统事件










