必须同时安装markdownediting和markdownpreview插件,并禁用sublime自带markdown包,否则.md文件仍显示plain text;package control未正确安装会导致后续所有插件失效,需通过控制台执行官方python脚本并重启sublime才能启用。

只装 MarkdownEditing 插件没用,必须配 MarkdownPreview + 手动关掉系统自带 Markdown 包,否则打开 .md 文件还是 Plain Text。
Package Control 装没装好,后面全白搭
按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS)调不出命令面板,或输 Package Control: Install Package 没反应,说明 Package Control 根本没跑起来。
- 别点菜单 Preferences → Install Package Control —— 这个选项早被移除了
- 打开控制台:
Ctrl+`,粘贴 packagecontrol.io/installation 上的 Python 3 安装脚本,回车执行 - 执行完必须彻底退出 Sublime 再重开,否则插件管理器不会注册进命令面板
- 重启后再次
Ctrl+Shift+P,搜Package Control: Install Package能响应才算成功
只装 MarkdownEditing 或只装 MarkdownPreview 都不行
这两个插件职责完全分离:前者管“写”,后者管“看”。漏一个,编辑或预览就断链。
- 没装
MarkdownEditing:.md文件打开就是Plain Text,标题不着色、列表无缩进、代码块无配色 - 没装
MarkdownPreview:右下角能显示Markdown GFM,但Ctrl+Shift+P里搜不到MarkdownPreview: Preview in Browser - 拼写必须严格:
MarkdownEditing(带ing),不是MarkdownEditor;MarkdownPreview(没空格),不是Markdown Preview
装完必须手动绑定语法,且禁用系统自带 Markdown 包
装完 MarkdownEditing 不会自动接管 .md 文件——你打开一个 Markdown 文件,右下角可能仍显示 Plain Text。
- 点击右下角语法标识(如
Plain Text),选择MarkdownEditing → Markdown GFM(推荐,支持表格、任务列表、围栏代码语言标识) - 设为默认:打开
Preferences → Settings – Syntax Specific,在右侧 JSON 中加入:{ "extensions": ["md","markdown","mkd","mdown"], "syntax":"Packages/MarkdownEditing/Markdown.tmLanguage" } - 检查是否误启用了自带的 Markdown 包:在
Preferences → Settings – Syntax Specific中确认没有残留"syntax": "Packages/Markdown/Markdown.sublime-syntax"
MarkdownPreview 打不开浏览器?先查配置再查路径
典型错误是点预览后没反应、弹空白页、或控制台报 [Errno 13] Permission denied——这和插件无关,是浏览器调用被系统拦了。
- Windows 用户最常见:默认路径含空格(如
C:\Program Files\Google\Chrome\Application\chrome.exe),直接导致权限拒绝 - 解决办法:打开
Preferences → Package Settings → MarkdownPreview → Settings – User,加一行:"browser": "default"
- 非要指定 Chrome:路径改用正斜杠 + 无空格路径,例如
"browser": "C:/Chrome/chrome.exe"
- macOS 预览空白?先关 Safari / Chrome 的「阻止弹出窗口」,或临时切
"browser": "safari"
最容易被忽略的是系统自带 Markdown 包没关干净,以及 Package Control 实际没生效却硬装插件——这两点卡住 90% 的人。只要控制台能跑命令、右下角能选到 Markdown GFM、预览命令能触发,剩下的就是主题和快捷键微调了。











