Package Control 是安装 Markdown 插件的前提，需先手动安装并确认成功；再装 MarkdownEditing（负责语法高亮与编辑）和 MarkdownPreview（负责实时预览与导出），二者分工明确、缺一不可。
Package Control 装不上就别硬装
Sublime Text 里装 Markdown 插件，本质是装 MarkdownEditing 或 MarkdownPreview，但前提是 Package Control 已就位。很多人卡在第一步：点菜单 Preferences → Install Package Control 没反应，或者装完后按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调不出命令面板。
常见错误现象：Package Control: Install Package 命令灰色不可选；终端里看到 Unable to download package list；装完插件后重启 Sublime，.md 文件仍无语法高亮。
- 确保网络能直连 GitHub（
Package Control的包源默认走 GitHub raw 链接，国内常被干扰） - 手动安装更稳：访问
https://packagecontrol.io/installation，复制对应 Sublime 版本的 Python 安装脚本，粘贴进 Sublime 的View → Show Console，回车执行 - 装完别急着关控制台——等它输出
Package Control: Installed X packages再操作下一步
MarkdownEditing 和 MarkdownPreview 到底装哪个
这两个不是二选一，而是分工明确：前者管「写」，后者管「看」。不装 MarkdownEditing，.md 文件打开就是纯文本，没有标题缩进、列表符号、代码块着色；不装 MarkdownPreview，你就只能靠脑补渲染效果。
使用场景差异：
-
MarkdownEditing：提供语法高亮、快捷键（如Ctrl+Alt+1插入一级标题）、侧边栏大纲（需配合SideBarEnhancements）、自动补全列表/引用 -
MarkdownPreview：按Ctrl+Shift+P输入Markdown Preview: Preview in Browser实时预览；支持导出 HTML、PDF；可配置用 GitHub 风格或原生解析器 - 注意：两者都依赖
Package Control，且安装后需重启 Sublime 或手动刷新语法（右下角点击语言名 →Markdown）
预览没反应？检查 Python 环境和 preview_settings
点了预览没弹浏览器，或页面空白，大概率不是插件坏了，而是环境或配置断了。Sublime 自带 Python，但 MarkdownPreview 默认会调用系统 Python 来跑解析逻辑（尤其导出 PDF 时），而 macOS 或某些 Linux 发行版可能缺 markdown 或 pygments 包。
常见错误现象：Markdown Preview: Preview in Browser 执行后控制台报 ImportError: No module named markdown；预览页面显示原始 Markdown 源码而非渲染结果。
- 先确认是否启用 GitHub 渲染模式：打开
Preferences → Package Settings → Markdown Preview → Settings，检查"enabled_parsers": ["github"]是否开启（免本地依赖） - 若想用本地解析，终端运行
pip install markdown pygments（注意：必须跟 Sublime 调用的 Python 一致；Sublime 4 默认用自带 Python 3.8，不认系统 pip） - Windows 用户遇到路径空格问题：预览时浏览器打不开，可能是
browser配置里写了带空格的路径（如C:\Program Files\Chrome\chrome.exe），改用短路径或删掉该配置让系统自动选
文件一保存就崩溃？关掉实时预览或换解析器
有些用户开大文档（>500 行），一按 Ctrl+S 就卡住甚至 Sublime 无响应，问题出在 MarkdownPreview 的自动刷新机制上。它默认监听保存事件，每次保存都触发一次完整解析 + 浏览器重载，对长文档很吃资源。
性能影响明显：小文档无感，但含大量代码块、表格或嵌套列表的文档，解析耗时可达 1–2 秒，期间 UI 冻结。
- 临时解决：关闭自动预览，在
Markdown Preview → Settings中设"enable_autoreload": false - 长期建议：保留自动预览，但把解析器从
markdown换成github（"parser": "github"），跳过本地解析环节，只发请求给 GitHub API，速度快且稳定 - 注意：
github解析器不支持自定义 CSS 或本地图片相对路径（会 404），这是权衡
插件本身不复杂，但 Sublime 的 Python 运行时、网络策略、文件监听机制这几个点串起来，就容易漏掉一环。最常被忽略的是：装完插件没手动切换语法模式，或者以为装了就能自动识别 .md 后缀——其实得右下角点一下，选成 Markdown 才真正生效。
