package control 必须通过官网python脚本安装并重启sublime才生效;需同时安装markdownediting和markdownpreview插件,且文件必须识别为markdown格式、配置正确解析器与浏览器,才能实现高亮与预览功能。

Package Control 装没装好,后面全白搭
Sublime 本身不认 .md 文件,也不带预览功能——所有“能高亮”“能刷浏览器”的能力,都得靠插件,而插件必须通过 Package Control 安装。很多人卡在第一步:按 Ctrl+Shift+P 搜不到 Package Control: Install Package,就去硬试搜 MarkdownPreview,结果当然失败。
实操建议:
- 用官网最新一行 Python 脚本(不是手动下载
package_control.sublime-package放错目录),粘贴进View → Show Console后直接回车 - 执行完必须重启 Sublime,否则
Package Control不注册进命令系统 - 重启后再次
Ctrl+Shift+P,输入Install Package能响应、有下拉菜单,才算真正就位 - 如果控制台报
UnicodeDecodeError,大概率是系统区域设置没启用 UTF-8,不是插件问题
必须同时装 MarkdownEditing 和 MarkdownPreview
只装一个,等于只完成一半:没 MarkdownEditing,.md 文件还是白底黑字,标题缩进不明显,代码块没配色;没 MarkdownPreview,右键没有 Preview in Browser,快捷键也触发不了预览。
常见错误现象:
- 装了
MarkdownPreview却发现文件仍是Plain Text模式——因为没装MarkdownEditing,Sublime 根本没把后缀识别为 Markdown - 装了
MarkdownEditing后右键没预览菜单——说明MarkdownPreview没装,或装了但被禁用(检查Preferences → Package Settings里有没有MarkdownPreview项) - 搜插件时输成
Markdown Preview(带空格)或MarkdownPreviewer——正确名字是MarkdownPreview(无空格,首字母大写)
markdown_preview 命令不生效?先查这四件事
MarkdownPreview 不绑定快捷键、不自动监听保存、也不保证每次点击都打开页面——它是个“需手动触发 + 配置才可用”的工具。命令面板里搜不到、点了没反应、打开空白页,几乎都出在这几个点上。
实操建议:
- 确认当前文件已保存,且后缀是
.md或.markdown;未保存的untitled标签不会预览 - 右下角状态栏必须显示
Markdown,不是Plain Text——点击它 →Open all with current extension as… → Markdown - 检查
Preferences → Package Settings → MarkdownPreview → Settings中"browser"是否为空或拼错,比如写成"Chrome"(应小写"chrome")或路径含中文 - 若预览报
command not found: markdown,说明系统 Python 缺markdown包,终端运行pip install markdown即可(Sublime 默认调用系统 Python)
想“改完就刷浏览器”,别信“实时”,要配 enable_autoreload
MarkdownPreview 没有 Typora 那种双栏同步,它的“自动刷新”其实是“保存后刷新已打开的浏览器页”。这个功能默认开启,但非常依赖文件系统事件,Windows 上容易漏触发,macOS 上有时重复刷,甚至导致标签页崩溃。
实操建议:
- 在
Preferences → Package Settings → MarkdownPreview → Settings中加一行:"enable_autoreload": true - 仅对已保存的本地文件有效,远程路径、未保存文件、符号链接均不触发
- 绑定快捷键更可靠:在
Preferences → Key Bindings – User里加:[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"github"}}] - 若数学公式不渲染、表格错位,别调 CSS——先改
"parser": "github"或"mistune",默认的markdown解析器不默认支持 GFM 表格和任务列表
最容易被忽略的是:预览效果不取决于你装了什么插件,而取决于你是否让 Sublime “知道这是 Markdown 文件”、是否让 MarkdownPreview “知道该用哪个解析器和浏览器”、以及是否接受了它“不真实时”的事实。配置比安装花的时间多,但每一步都有明确反馈路径。











