sublime text 需安装 markdownediting 和 markdownpreview 两个核心插件并禁用自带 markdown 语法包，才能实现正确语法高亮、中文标题显示、列表缩进及实时 html 预览。
Sublime Text 本身不原生支持 Markdown 实时预览或语法高亮优化，但通过合理安装插件和调整设置，能快速构建出高效、稳定的写作环境。关键不是装得越多越好，而是选对 MarkdownEditing、MarkdownPreview 这两个核心插件，并关闭默认的 Markdown 语法包干扰。
如何正确安装 MarkdownEditing 插件
这是解决「中文标题乱码」「列表缩进错位」「代码块高亮失效」等问题的基础。系统自带的 Markdown 语法包过于简陋，且不维护；MarkdownEditing 提供完整语法定义、主题适配和快捷键支持。
- 用
Package Control: Install Package命令搜索并安装MarkdownEditing（注意名称里有Editing，不是Editor或Preview） - 安装后手动将文件关联：右下角点击当前语法名 →
Open all with current extension as...→ 选择MarkdownEditing/Markdown - 若发现标题前的
#不高亮或缩进异常，检查是否误启用了自带的Markdown语法包——在Preferences → Settings – Syntax Specific中确认没有残留"syntax": "Packages/Markdown/Markdown.sublime-syntax"
配置 MarkdownPreview 实现实时 HTML 预览
MarkdownPreview 是目前 Sublime 下最稳定、可离线、支持 GitHub/GitLab 渲染风格的预览方案。它不依赖 Python 服务进程，也不强制联网，适合写文档、发 PR 描述或生成静态页。
- 安装后，在任意
.md文件中按ctrl+shift+P（Windows/Linux）或cmd+shift+P（macOS），输入MarkdownPreview，选择MarkdownPreview: Preview in Browser - 默认使用 GitHub 样式，如需切换为 GitLab 或本地渲染，修改用户配置：
Preferences → Package Settings → MarkdownPreview → Settings，添加：{ "markdown_extensions": ["extra", "codehilite", "toc", "fenced_code"], "github_mode": true, "enable_highlight": true } - 注意：如果预览空白或报
No module named 'markdown'，说明你装了旧版（v1.x）或与 Python 环境冲突。卸载重装 v2.4+ 即可，新版已内嵌解析器，无需额外pip install markdown
常用快捷操作与避坑提示
很多效率问题其实来自快捷键冲突或未启用关键功能，比如标题自动补全、TOC 生成、图片路径补全等，这些都由 MarkdownEditing 提供，但默认未开启全部。
- 标题快捷键：
ctrl+1~ctrl+6插入对应级数标题（macOS 用cmd），前提是光标位于行首且该行为空；若无效，检查是否被其他插件劫持——在Preferences → Key Bindings中搜索heading确认绑定存在 - 插入链接/图片建议用
ctrl+shift+p→MarkdownEditing: Insert Link，它会自动补全相对路径（如从docs/下插入图片时，路径自动转为../assets/logo.png） - 不要手动改
Preferences → Settings里的"word_wrap": true来实现软换行——这会让代码块折行错乱。应使用MarkdownEditing自带的Wrap Lines命令（ctrl+shift+w），它只对段落生效，跳过代码块和表格
真正卡住人的往往不是插件装不上，而是多个 Markdown 相关包共存导致语法识别打架，或者预览时用了错误的扩展配置。把 MarkdownEditing 设为唯一语法处理器，把 MarkdownPreview 当作独立预览工具，中间不混用其他“增强包”，环境就足够干净可靠。路径补全、TOC 生成这些进阶功能，等基础预览和编辑稳了再开不迟。
