MarkdownPreview插件不支持真正实时预览，所谓“实时”实为保存后自动刷新浏览器标签页，需满足文件已保存、语法设为Markdown、首次手动触发预览等前提条件，否则易出现空白页、公式不渲染或快捷键失效等问题。

MarkdownPreview

插件本身不提供真正意义上的实时预览，所谓“实时”只是保存后自动刷新浏览器标签页，且依赖一系列前提条件。直接上手就指望 Ctrl+S 后页面秒变，大概率会卡在空白页、乱码、公式不渲染或快捷键失灵上。

为什么 Ctrl+Alt+M 按了没反应？

这不是插件坏了，而是触发条件没满足：

• 当前文件必须已保存为 .md 或 .markdown 后缀，且右下角状态栏显示的是 Markdown（不是 Plain Text）；如果不是，点击状态栏 → Set Syntax → Markdown
• MarkdownPreview 插件默认只在 text.html.markdown 作用域响应快捷键，语法识别错，快捷键就完全失效
• Sublime 3 用户若系统 Python 版本低于 3.6，或 Sublime 4 的内置 Python 被异常覆盖，控制台会报 ImportError: No module named 'html.parser' —— 此时需重装官方版 Sublime
• 插件安装后未重启 Sublime，命令面板搜不到 Markdown Preview: Preview in Browser，快捷键自然无效

怎么让保存后浏览器自动刷新？

关键配置只有两个字段，但顺序和首次操作不能错：

• 打开 Preferences → Package Settings → Markdown Preview → Settings – User
• 填入以下内容（注意是 Settings – User，不是 Settings – Default）：

  {
    "enable_autoreload": true,
    "browser": "chrome"
  }

• 必须先手动执行一次 Markdown Preview: Preview in Browser，插件才会启动本地服务并缓存依赖；之后再保存，才会向该标签页发刷新指令
• Chrome/Edge 用户需关闭 chrome://settings/privacy 中的“使用预测服务来加载网页”，否则可能拦截 file:// 协议的自动刷新

数学公式、Mermaid 图表为什么不显示？

它们默认是关闭的，且启用方式不同：

Markdown Toolkit

Markdown瑞士军刀——目录生成、格式转换(MD↔HTML)、损坏格式修复、HTML剥离、文件合并、YAML frontmatter验证器、...

下载

• 数学公式：加 "mathjax_enabled": true，并在文档中用 $$...$$ 或 \(...\) 包裹，不用额外引入 JS
• Mermaid 图表：仅靠 mathjax_enabled 不行，必须显式配置扩展：

  "markdown_extensions": [
    "extra",
    "fenced_code",
    "tables",
    "mdx_math",
    "mermaid2"
  ]

  （注意：mermaid2 需提前 pip install mermaid2，且与 Sublime 调用的 Python 环境一致）
• 中文锚点跳转失效？补上 "html_preview": true 和 "enable_highlight": true，确保 URL 编码被正确解析

预览样式丑、代码块没高亮、离线打不开？

默认走 GitHub API 渲染，离线即失效，且不支持自定义 CSS：

• 切到本地 Pygments 渲染器：设 "parser": "markdown" + "markdown_extensions": ["fenced_code", "codehilite"]
• 确保已运行 pip install Pygments（用 Sublime 内置 Python 执行，不是系统全局 Python）
• 自定义 CSS 路径要写对，比如："css": ["Packages/Markdown Preview/css/custom.css"]，然后把文件放进去
• 别双击生成的 temp.html 文件——它依赖 Sublime 的本地资源代理，脱离插件环境就是乱码+白屏

真正麻烦的从来不是配几个字段，而是每一步都卡在隐性依赖上：Python 环境是否干净、路径是否含中文、浏览器策略是否拦截、首次预览是否手动触发过。这些环节漏掉任意一个，“实时”就退化成“手动按五次快捷键还看不到公式”。