必须同时安装markdownediting和markdownpreview插件，缺一不可；仅装其一将导致.md文件显示为plain text或预览命令不可用。package control须通过官方python脚本安装并重启验证，控制台显示“installed 1 package”且命令面板可调出install package才算成功。
必须装 MarkdownEditing + MarkdownPreview，缺一不可；只装一个，.md 文件不是白底黑字就是点不开预览。
Package Control 装没装成功，三秒就能验证
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package。能立刻弹出包列表，才算真装好。
- 如果命令灰色、无响应、或报
command not found，说明脚本没执行完或没重启——别信“已安装”，重来 - 控制台粘贴的安装脚本必须一次性回车（不能手动换行），且执行后要看到
Package Control: Installed 1 package - 国内用户若卡在
Loading packages...，把脚本里packagecontrol.io换成packagecontrol.cn，哈希值保持不变即可 - 装完必须彻底退出 Sublime（macOS 要右键 Dock 图标 → “退出”），再重开，否则插件不注册进命令面板
MarkdownEditing 和 MarkdownPreview 必须一起装
这两个插件职责完全分离：前者让 Sublime “认出” .md 文件并提供编辑支持，后者才负责渲染和预览。
- 只装
MarkdownPreview：打开 .md 文件右下角显示Plain Text，Markdown Preview: Preview in Browser命令根本不会出现在命令面板里 - 只装
MarkdownEditing：能高亮、能用Ctrl+Alt+1~6插标题，但点预览会报command not found: markdown_preview - 拼写必须严格：
MarkdownEditing（带ing），不是MarkdownEditor；MarkdownPreview（无空格），不是Markdown Preview或MarkdownLivePreview（后者已多年未更新，ST4+ 上保存不刷新、中文乱码） - 装完重启后，打开任意
.md文件，点击右下角语言名 → 选MarkdownEditing → Markdown GFM，否则 GitHub 表格、任务列表、数学公式全不生效
预览打不开、空白页、公式不显示？先查 parser 和 browser 配置
90% 的“预览失败”不是插件问题，而是配置没对或路径被系统拦截。
- 预览没反应或弹空白页：Windows 上常见于 Chrome 默认路径含空格（如
C:\Program Files\Google\Chrome\Application\chrome.exe），触发[Errno 13] Permission denied；解决方法是进Preferences → Package Settings → Markdown Preview → Settings – User，加一行："browser": "default" - 预览出来是白底黑字、表格错位：说明 parser 还是默认的
markdown，没启用 GitHub 渲染；必须在 Settings – User 里明确写："parser": "github"+"github_mode": true - 数学公式显示为原始 LaTeX：除了
"enable_mathjax": true，parser 不能用gfm（它不支持 MathJax），必须用github或markdown - 快捷键没绑定？默认不设任何快捷键；进
Preferences → Key Bindings – User加这行：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
最容易被忽略的一点：所有配置项都得写在 Settings – User 文件里，不是 Settings – Default；改错文件等于没改。另外，未保存的临时文件（untitled）不会触发 enable_autoreload，自动刷新只对已保存的本地 .md 文件有效。
