package control未装好，后续所有插件均无法正常使用；必须用官方最新python脚本安装并重启，控制台显示“installed 1 package”才算成功，国内用户可替换域名并更新哈希值。
Package Control装不上，后续全白搭
没装好 Package Control，就别急着搜 Markdown 插件——90% 的“点不开预览”“命令找不到”问题都卡在这一步。
常见错误现象：Package Control: Install Package 命令灰色不可用、控制台报 Unable to download package list、安装完插件后重启 Sublime 仍显示 Plain Text。
- 必须用官方最新 Python 脚本安装（不是拖文件进
Packages/目录），粘贴到View → Show Console执行 - 执行后控制台要看到
Package Control: Installed 1 package才算成功，之后必须彻底退出 Sublime 再重开 - 国内用户若一直卡在
Loading packages…，可把脚本里packagecontrol.io换成packagecontrol.cn，并同步更新哈希值（2026 年已知有效）
MarkdownEditing 和 MarkdownPreview 必须一起装
只装一个等于没装：前者管语法识别和高亮，后者只负责渲染 HTML。缺一不可，且分工不能互换。
常见错误现象：
- 只装
MarkdownPreview：打开.md文件仍是白底黑字，右下角显示Plain Text，Markdown Preview: Preview in Browser命令压根不出现 - 只装
MarkdownEditing：能高亮、能快捷插入标题，但点预览会报错command not found: markdown_preview - 装完两个却没效果：右下角语言标识没手动设为
MarkdownEditing → Markdown GFM，GitHub 表格、任务列表等特性不会生效
预览空白、公式不显示、点不动？查 Python 和 parser 配置
MarkdownPreview 默认调用系统 Python 解析 Markdown，不是 Sublime 自带的 Python。很多空白页或控制台报错都源于此。
- 报错
ImportError: No module named markdown：运行pip install markdown（注意是系统 Python，不是 Sublime 自带的那个） - 预览出来是纯文本而非 HTML：检查
Preferences → Package Settings → Markdown Preview → Settings，确认有"parser": "github"或"github_mode": true - 数学公式不显示：必须加
"enable_mathjax": true，且parser得设为github或markdown；gfm模式不支持 MathJax - Windows 上报
[Errno 13] Permission denied：把设置里的"browser"改成"default"，或路径避开空格/中文，如"browser": "C:/Chrome/chrome.exe"
快捷键、自动刷新、图片路径这些得手动配
MarkdownPreview 默认没快捷键，也不监听保存动作。“实时预览”是假象，得自己补。
- 加快捷键：进
Preferences → Key Bindings，右侧用户配置里加一行：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}} - 开启保存即刷新：在设置中加
"enable_autoreload": true，但注意——仅对已保存的本地文件有效，未保存或远程路径不触发 - 图片不显示：预览用的是
file://协议，Chrome 等浏览器会拦截相对路径图片；要么改用python -m http.server 8000启本地服务，再配"custom_browser": "http://localhost:8000/{file_path}"，要么确保所有图片路径是绝对 URL
最易被忽略的点：插件配置全写在 Settings – User 里，不是 Settings – Default；所有路径用正斜杠 /，别用反斜杠 \；UTF-8 编码和 .md 后缀是硬性前提，缺一不可。
