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 命令
命令不可见 ≠ 插件没装,而是启动流程断在了前几步。常见卡点有三个:
- 插件名拼错:必须安装
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文件为基准,例如;绝对路径、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 开关——这四个点漏掉任何一个,预览就大概率不动如山。


















