Sublime Text 的 MarkdownEditing 插件需手动配置语法高亮、默认关联、预览依赖（MarkdownPreview）及快捷键，否则标题无色、预览失效、快捷键冲突；调试应优先检查右下角语法标识与控制台报错。
Sublime Text 默认对 Markdown 的支持很基础，MarkdownEditing 插件不是“装上就变好用”，而是必须手动配置才能真正提升写作效率——尤其在预览、语法高亮、快捷键和代码块渲染方面。
用 Package Control 安装插件前先确认 Python 环境是否正常
Sublime Text 3/4 内置 Python，但部分系统（尤其是 macOS 或自定义安装的 ST）可能因路径或权限问题导致 Package Control 安装失败。如果按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后不弹出命令面板，或输入 Install Package 无响应，说明 Package Control 本身没装好。
- 重新安装
Package Control：访问https://packagecontrol.io/installation，复制对应版本的 Python 安装代码，粘贴进 Sublime 的View → Show Console并回车 - 安装完成后重启 Sublime，再用
Ctrl+Shift+P输入Package Control: Install Package，等待加载完成后再搜MarkdownEditing - 若仍卡在 “Loading packages…”，检查是否有防火墙或代理拦截了
https://packagecontrol.io
安装后必须手动设置语法高亮和默认关联
装完 MarkdownEditing 不会自动接管 .md 文件——你打开一个 Markdown 文件，右下角可能仍显示 Plain Text，代码块、标题、列表全无颜色。
- 点击右下角语法标识（如
Plain Text），选择MarkdownEditing → Markdown GFM（推荐）或MarkdownEditing → Markdown - 设为默认：打开
Preferences → Settings – Syntax Specific，在右侧 JSON 中加入：{ "extensions": ["md", "markdown", "mkd", "mdown"], "syntax": "Packages/MarkdownEditing/Markdown.tmLanguage" } - 注意：
Markdown GFM支持 GitHub Flavored Markdown（表格、任务列表、围栏代码语言标识），而原生Markdown不支持；但某些旧主题对GFM高亮适配较差，可按需切换
预览功能依赖外部工具，不能只靠插件本身
MarkdownEditing 自带的 Ctrl+Shift+P → MarkdownPreview: Preview in Browser 命令，实际调用的是 MarkdownPreview 插件，不是它原生能力。很多用户装完 MarkdownEditing 却点不动预览，就是因为漏装了依赖。
- 必须额外安装
MarkdownPreview插件（同样通过Package Control） - 安装后首次运行会提示安装
python-markdown库；若报错No module named 'markdown'，需在终端执行：pip install markdown
- Windows 用户若用 Anaconda，可能需指定 Python 路径：在
Preferences → Package Settings → MarkdownPreview → Settings中修改"markdown_extensions"和"python_binary" - 预览样式默认较简陋，如需 GitHub 风格，启用
"github_css": true并确保网络可访问https://github.githubassets.com
常用快捷键冲突与自定义建议
插件自带的快捷键（比如 Ctrl+Alt+1 插入一级标题）容易和系统或其它插件冲突，且部分快捷键在中文输入法下失效。
- 查看当前绑定：打开
Preferences → Key Bindings，左侧是默认键位，右侧可覆盖；搜索markdown查所有相关命令 - 推荐重映射易触发组合：
[ { "keys": ["ctrl+alt+h"], "command": "insert_heading", "args": {"level": 1} }, { "keys": ["ctrl+alt+b"], "command": "markdown_toggle_bold" } ] - 避免用
Ctrl+1/2/3：这些常被 Windows / macOS 系统用于切换桌面，极易误触发 - 代码块插入快捷键
Ctrl+Shift+K和 Sublime 默认的「行排序」冲突，建议改为Ctrl+Alt+k
真正卡住人的从来不是“怎么装”，而是装完发现标题没颜色、预览打不开、快捷键按了没反应——这些问题几乎都出在语法绑定、依赖缺失或快捷键覆盖上。调试时优先看右下角语法名、控制台报错（View → Show Console），比反复重装插件有效得多。
