sublime text 本身不支持 markdown 高亮与预览，需组合使用 markdownediting（负责语法高亮）和 markdownpreview（负责浏览器渲染）；必须手动绑定 .md 文件到 markdown 语法、重启 sublime、确认 python ≥3.6、启用 enable_autoreload 并正确配置 parser 才能正常预览。

Sublime Text 本身不提供 Markdown 高亮预览功能，必须靠插件组合实现：MarkdownEditing 负责语法高亮，MarkdownPreview 负责浏览器渲染——装完不配置，等于白装。

怎么让 .md 文件自动高亮（不是 Plain Text）

右下角状态栏显示 Plain Text 是最常见拦路虎。这不是插件没装好，而是 Sublime 没把 .md 当 Markdown 处理。

• 打开任意 .md 文件，点击右下角当前语法名（比如 Plain Text）→ 选择 Open all with current extension as... → 找到并选中 Markdown GFM（来自 MarkdownEditing 插件）或 Markdown（Sublime 自带）
• 若列表里没有 Markdown GFM，说明 MarkdownEditing 没装对或没重启；确认安装的是 MarkdownEditing，不是 Markdown Preview
• 装完 MarkdownEditing 后，它会自动注册 .md、.markdown 等后缀，但首次仍需手动绑定一次
• 绑定后，所有新打开的 .md 文件都会默认使用增强高亮，标题、代码块、列表符号颜色分明

为什么 Ctrl+Shift+P 里搜不到 Markdown Preview 命令

命令不可见 ≠ 插件没装，而是启动流程断在了前几步。常见卡点有三个：

Markdown Viewer

用于 AI 配对编辑的实时 Markdown 查看器，协作时更新即时渲染，支持任意 AI 代理和网页浏览器。

下载

• 插件名拼错：必须安装 MarkdownPreview（结尾是 Preview），不是 MarkdownPreviewer、LivePreview 或 MarkdownEditing
• 没重启 Sublime：Package Control 安装完插件后，必须完全退出再重开，否则命令面板不加载新命令
• Python 环境异常：插件依赖 Python 执行解析逻辑；若系统 Python 升级或 python_binary 配置错误，命令会静默失效——先运行 python --version 确认 ≥3.6，再检查 Preferences → Package Settings → Markdown Preview → Settings 中的 python_binary 是否指向正确路径

预览打开空白页 / 图片不显示 / 中文锚点跳转失败

这些问题几乎都源于配置项没对齐，而不是文件本身写错了。

• 空白页：检查 Preferences → Package Settings → Markdown Preview → Settings 中是否启用了 "enable_autoreload": true；首次预览必须手动触发 Markdown Preview: Preview in Browser，不能指望保存就弹窗
• 图片不显示：路径必须是相对路径，且以 .md 文件为基准，例如 ![](images/logo.png)；绝对路径、file:// 协议、或用 ../ 跨目录但未配 http_server 均会失败
• 中文锚点失效（如 [跳转](#中文标题) 点击无反应）：必须同时开启 "html_preview": true 和 "enable_highlight": true，二者缺一不可——后者会激活 URL 解码逻辑，否则浏览器地址栏显示 %E4%B8%AD%E6%96%87 但页面找不到对应 id

要不要换 parser？Pygments 还是 GitHub？

默认的 github parser 渲染快、样式固定，但离线失效、代码无高亮、表格支持弱；markdown（即 Python-Markdown）可本地定制，但依赖扩展和 Pygments。

• 要离线 + 高亮 + 自定义 CSS：设 "parser": "markdown"，并确保已运行 pip install Pygments（注意：必须和 Sublime 调用的 Python 是同一环境）
• 嫌配 Pygments 麻烦：直接切 "parser": "mistune"，轻量、支持 GFM 表格和任务列表，无需额外依赖
• 要 GitHub 原生样式且能联网：用 "parser": "github"，但得去 GitHub Personal Access Token 申请 token，并填入配置里的 "github_personal_token" 字段
• 别手动改 markdown_extensions 却不配依赖：比如加了 "codehilite" 却没装 Pygments，预览会静默回退到纯文本

真正卡住人的，从来不是“怎么装”，而是“装完之后哪几处配置必须动、哪几个状态必须确认”。状态栏语法、Python 版本、parser 选择、autoreload 开关——这四个点漏掉任何一个，预览就大概率不动如山。