Sublime Text需通过MarkdownPreview插件实现Markdown预览，启用实时刷新需配置"enable_autoreload": true并手动首次预览；依赖Python环境，须正确设置语法类型、浏览器安全策略及扩展（如mathjax_enabled、mermaid）以支持公式和图表。

Sublime Text 本身不支持 Markdown 实时预览，必须通过插件实现；官方推荐且目前最稳定的是 MarkdownPreview，但默认配置下它不“实时”，需要手动触发或额外启用监听模式。

装完 MarkdownPreview 为什么按快捷键没反应？

常见原因是未正确关联文件类型或未安装依赖：

• 确保当前文件后缀是 .md 或 .markdown，且右下角状态栏显示 “Markdown” 语法（不是 Plain Text）；如果不是，点击状态栏 → Set Syntax → Markdown
• MarkdownPreview 依赖 Python 环境，Sublime 4 内置 Python 3.8+，但 Sublime 3 用户需确认系统已安装 Python 3.6+ 并在 PATH 中可调用
• 安装插件后需重启 Sublime，否则 ctrl+shift+p（Windows/Linux）或 cmd+shift+p（macOS）调出命令面板时搜不到 Markdown Preview
• 首次使用前建议执行一次 Markdown Preview: Preview in Browser 命令，插件会自动下载并缓存 Pygments、Markdown 等依赖

MarkdownPreview 怎么开启“实时刷新”？

它没有原生的“保存即刷新”功能，但可通过配置 + 浏览器配合模拟实时效果：

Browse website - Crawls sites automatically and mounts pages as markdown files you can grep, diff, cat, and explore with standard Unix commands — over SSH or HTTP

将任意网站转换为文件系统，自动抓取网站并将页面挂载为 Markdown 文件，可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。

下载

• 在 Sublime 中打开 Preferences → Package Settings → Markdown Preview → Settings
• 在用户设置中添加：

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

  其中 enable_autoreload 是关键——它会让插件在检测到文件变更（保存）时，自动向已打开的浏览器标签页发送刷新指令
• 首次预览必须手动执行一次 Markdown Preview: Preview in Browser，之后只要该浏览器标签页保持打开且 URL 是 file://... 或 http://127.0.0.1:...，保存即刷新
• 注意：Chrome/Edge 需关闭“预测网络操作”（chrome://settings/privacy → 关闭“使用预测服务来加载网页”），否则可能拦截本地文件自动刷新

为什么预览样式丑 / 不支持 Mermaid / 数学公式？

默认渲染走的是 Python-Markdown + GitHub CSS，基础但简陋；高级功能需显式启用扩展：

• 数学公式：在用户设置中加入 "mathjax_enabled": true，并在 MD 文档中用 $$...$$ 或 \(...\) 包裹公式
• Mermaid 图表：需额外配置 "markdown_extensions"，例如：

  "markdown_extensions": [
    "fenced_code",
    "tables",
    "def_list",
    "footnotes",
    "attr_list",
    "md_in_html",
    {
      "mermaid": {
        "enabled": true
      }
    }
  ]

  注意：Mermaid 渲染依赖浏览器端 JS，需确保预览页加载了对应脚本（插件会自动注入）
• 自定义 CSS：把 CSS 文件路径填入 "css": ["path/to/custom.css"]，路径支持相对路径（相对于 Sublime 的 Packages 目录）或绝对路径
• 不推荐强行开启 "github_mode": true 来套用 GitHub 样式——它会禁用所有本地扩展（如 Mermaid、自定义 CSS），且无法离线使用

真正卡住人的往往不是装不上，而是 enable_autoreload 没开、浏览器被安全策略拦住、或者语法高亮和预览用的不是同一套解析逻辑。调试时盯住 Sublime 控制台（ctrl+`）里有没有 MarkdownPreview 报错，比反复重装插件有用得多。