必须同时安装MarkdownEditing和MarkdownPreview插件,缺一不可;Package Control未装好则后续全失败,需用官网Python脚本安装并重启Sublime;.md文件需手动设为Markdown GFM语法,否则白底黑字;预览异常多因浏览器路径含空格或Python环境缺失,应配"browser": "default"及pip install markdown;数学公式、快捷键、自动刷新等功能须在Settings–User中手动配置。

装 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
为什么 .md 文件还是白底黑字?
只装插件不设语法,等于没装。Sublime 不会自动把 .md 文件绑定到 Markdown 语法,得手动设一次:
- 打开任意
.md文件 → 点右下角当前语言名(比如显示Plain Text)→ 选MarkdownEditing→Set Syntax: Markdown GFM - 想永久生效:菜单
View → Set Syntax → Open all with current extension as…→ 再选Markdown GFM - 漏掉这步,GitHub 表格、任务列表、自动缩进等特性全不生效
点预览没反应、弹空白页、报 [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 自带的那个)
数学公式不渲染、快捷键没绑定、保存后不自动刷新
这些都不是默认开启的功能,得自己补配置:
- 公式支持:Settings – User 里加
"enable_mathjax": true,且"parser"必须是"github"或"markdown"("gfm"模式不支持 MathJax) - 快捷键:进
Preferences → Key Bindings,右侧用户配置加一行:{"keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}} - 自动刷新:Settings – User 加
"enable_autoreload": true,再装 LiveReload 插件,启用Simple Reload with delay (400ms)
最容易被忽略的是:所有配置都必须写进 Settings – User 文件,而不是 Settings – Default;还有,MarkdownEditing 和 MarkdownPreview 的拼写不能错——前者带 ing,后者没空格,输成 MarkdownEditor 或 Markdown Preview 就找不到。


















