必须同时安装MarkdownEditing和MarkdownPreview，缺一不可；前者负责语法高亮与快捷编辑，后者负责HTML预览及公式渲染，二者无自动联动，需手动设置右下角语法为Markdown GFM并重启Sublime。
必须同时安装 MarkdownEditing 和 MarkdownPreview，缺一不可；只装一个会导致语法不亮、预览报错或命令根本不出现在命令面板里。
Package Control 装没装好，后面全白搭
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后搜不到 Package Control: Install Package，说明它压根没跑起来。这不是网络慢，而是安装失败或未重启。
- 用官方最新 Python 3 安装脚本：访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，复制对应 Sublime Text 3 或 4 的代码
- 在 Sublime 中按
Ctrl+`打开控制台，粘贴并回车执行（别手动换行） - 等控制台输出
Package Control: Installed 1 package后，**必须退出并重启整个 Sublime 程序** - 国内用户若卡在
Loading packages...，可临时关代理，或把脚本中packagecontrol.io换成packagecontrol.cn（2026 年已知有效）
装完插件，.md 文件还是 Plain Text？
插件装成功 ≠ 自动生效。Sublime 不会主动把 .md 文件交给 MarkdownEditing 渲染，右下角显示 Plain Text 是最常见“假失败”现象。
- 打开任意
.md文件 → 点右下角当前语法名（如Plain Text）→ 选MarkdownEditing → Markdown GFM - 想永久绑定：点菜单
View → Set Syntax → Open all with current extension as...→ 再选MarkdownEditing → Markdown GFM - 注意：
Markdown GFM支持表格、任务列表、围栏代码块语言标识；原生Markdown不支持，但某些老主题对 GFM 高亮适配差，可按需切换
预览点不动、浏览器空白、公式不渲染？查这三处
MarkdownPreview 默认调用系统 Python（不是 Sublime 内置的），很多“预览失败”本质是环境或配置断了，不是插件坏了。
- 控制台报
ImportError: No module named markdown：运行pip install markdown（确保用的是它调用的那个 Python） - 预览页面显示原始 Markdown 源码而非渲染结果：打开
Preferences → Package Settings → Markdown Preview → Settings，确认"parser": "github"或"parser": "markdown"已设，且"enabled_parsers": ["github", "markdown"]包含对应项 - 数学公式不显示：在同个设置文件里加
"enable_mathjax": true，并确保你用的是github或markdownparser（gitlabparser 不支持 MathJax）
快捷键和构建系统别乱配
Ctrl+B 默认是构建命令，但 MarkdownPreview 不走构建系统——它靠命令面板或自定义快捷键触发。硬绑 Ctrl+B 到预览，反而会让其他构建任务失效。
- 推荐快捷键：打开
Preferences → Package Settings → Markdown Preview → Key Bindings，在右侧用户文件加： [ {"keys": ["ctrl+shift+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}} ]- 别在全局
Key Bindings里改，否则可能被其他插件覆盖；也别用build相关命令模拟预览，路径和上下文都不对
真正容易被忽略的点是：两个插件功能完全不重叠，MarkdownEditing 不负责预览，MarkdownPreview 不负责高亮——它们之间没有自动联动机制，所有关联都得人来配。哪怕只漏掉一次右下角语法切换，整个流程就卡死在第一步。
