必须同时安装MarkdownEditing和MarkdownPreview插件,缺一不可;Package Control未成功安装则后续全失败,需用官网Python脚本安装并彻底重启Sublime;.md文件须手动设为Markdown GFM语法,否则白底黑字;预览异常多因浏览器路径含空格或缺失markdown模块,应配"browser": "default"及pip install markdown。

必须装 MarkdownEditing 和 MarkdownPreview 两个插件,缺一不可;Package Control 没装好,后面全白搭。
Package Control 装没装成功,三秒就能验
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control: Install Package。能立刻弹出包列表,才算真正就位。
如果命令灰色、无响应、或提示 command not found,说明安装失败:
- 别点菜单里那个
Preferences → Install Package Control——Sublime Text 4 早删了这选项 - 必须用官网最新 Python 3 脚本:按
Ctrl+`打开控制台,粘贴 packagecontrol.io/installation 上的代码,一次性回车执行 - 控制台输出
Package Control: Installed 1 package后,必须彻底退出 Sublime 再重开,否则命令面板不注册 - 国内用户若卡在
Loading packages,可临时把脚本里packagecontrol.io替成packagecontrol.cn
MarkdownEditing 和 MarkdownPreview 到底装哪个
这不是二选一,而是分工明确:
-
MarkdownEditing管「写」:提供标题高亮、列表自动缩进、Ctrl+Alt+1~6插入标题、代码块语言识别——没它,.md文件打开就是Plain Text,白底黑字 -
MarkdownPreview管「看」:支持Ctrl+Shift+P→Markdown Preview: Preview in Browser实时预览、导出 HTML/PDF、启用enable_mathjax渲染公式——没它,你只能靠脑补渲染效果 - 拼写必须严格:
MarkdownEditing(带ing),不是MarkdownEditor;MarkdownPreview(无空格),不是Markdown Preview
.md 文件还是白底黑字?语法没手动设
Sublime 不会自动把 .md 文件绑定到 Markdown 语法,得手动设一次:
- 打开任意
.md文件 → 点右下角当前语言名(比如显示Plain Text)→ 选MarkdownEditing→Set Syntax: Markdown GFM - 想永久生效:菜单
View → Set Syntax → Open all with current extension as…→ 再选Markdown GFM - 漏掉这步,GitHub 表格、任务列表、自动缩进等特性全不生效
- 如果标题前的
#不高亮或缩进异常,检查是否误启用了自带的 Markdown 语法包——在Preferences → Settings – Syntax Specific中确认没有残留"syntax": "Packages/Markdown/Markdown.sublime-syntax"
点预览没反应、弹空白页、报 [Errno 13] Permission denied
这不是插件坏了,而是系统拦截了浏览器调用。Windows 用户最常见:Chrome 默认路径含空格(如 C:\Program Files\Google\Chrome\Application\chrome.exe),Python 调用直接被拒。
- 最稳解法:打开
Preferences → Package Settings → MarkdownPreview → Settings – User,加一行:"browser": "default" - 非要指定 Chrome:路径改用正斜杠 + 无空格路径,例如
"browser": "C:/Chrome/chrome.exe" - macOS 预览空白?先关 Safari / Chrome 的「阻止弹出窗口」,或临时设
"browser": "safari" - 控制台报
ImportError: No module named markdown?运行pip install markdown(注意是系统 Python,不是 Sublime 自带的那个)
最容易被忽略的是:装完插件后没手动设置语法,或者 Package Control 安装后没彻底重启 Sublime —— 这两步跳过,整个流程就卡死在起点。


















