Sublime Text 需通过 Package Control 安装 MarkdownEditing 和 MarkdownPreview 插件组合才能实现完整 Markdown 编辑与预览功能，前者负责语法高亮与快捷编辑，后者支持 HTML 预览及数学公式、Mermaid 渲染。
Sublime Text 本身不原生支持 Markdown 实时预览和语法增强，但通过 Package Control 安装插件可以快速补全核心能力。关键不是“装哪个插件”，而是装对组合：MarkdownEditing 提供专业语法高亮与编辑快捷键，MarkdownPreview 负责 HTML 预览（含数学公式、Mermaid 支持），二者配合才构成可用的写作环境。
如何确认 Package Control 已安装并可用
这是所有插件安装的前提。如果按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）后弹出命令面板但搜不到 Package Control: Install Package，说明未安装或损坏。
- 访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，复制对应 Sublime 版本（Sublime Text 3 或 4）的 Python 安装代码
- 在 Sublime 中按 Ctrl+` 打开控制台，粘贴代码并回车 —— 注意：不要手动换行，必须一次性执行
- 重启 Sublime，再次 Ctrl+Shift+P 搜索
Package Control: Install Package，能出现即成功 - 若控制台报错
UnicodeDecodeError，大概率是系统 locale 设置异常，需检查系统区域设置中是否启用了 UTF-8
必须安装的两个核心插件及其作用差异
MarkdownEditing 和 MarkdownPreview 功能不重叠，缺一不可。前者管“写”，后者管“看”。只装一个会导致：能高亮但无法预览，或能预览但标题/列表/代码块缩进混乱。
-
MarkdownEditing：提供Ctrl+Alt+1~6快速插入标题、Ctrl+Alt+K插入链接、自动补全列表符号等；默认启用 GitHub Flavored Markdown（GFM）语法 -
MarkdownPreview：支持本地预览（Ctrl+Shift+P→Markdown Preview: Preview in Browser），可配置输出为 GitHub / GitLab / MkDocs 样式；启用enable_mathjax后支持 LaTeX 公式渲染 - 安装方式统一：Ctrl+Shift+P → 输入
Package Control: Install Package→ 分别搜索并安装这两个名字，注意拼写大小写和空格 - 安装后无需重启，但需将文件后缀设为
.md或.markdown，右下角状态栏应显示Markdown语言模式
常见预览失败原因与修复方法
点击预览无反应、浏览器打开空白页、数学公式不渲染——这些问题几乎都源于配置或路径偏差，而非插件本身故障。
- 预览时提示
command not found: markdown：说明系统未安装 Python 的markdown包，运行pip install markdown即可（Sublime 默认调用系统 Python） - 公式不显示，控制台报
MathJax is not defined：在Preferences → Package Settings → Markdown Preview → Settings中，确保"enable_mathjax": true且未被注释 - 中文路径下预览乱码或 404：修改
MarkdownPreview.sublime-settings中的"html_encoding": "UTF-8"，并确认文件路径不含空格或特殊符号 - Mermaid 图表不渲染：需额外启用
"enable_mermaid": true并确保网络可访问cdn.jsdelivr.net（国内用户建议配代理或改用本地 Mermaid CLI）
{
"enabled_extensions": ["fenced_code", "tables", "footnotes", "attr_list"],
"enable_mathjax": true,
"enable_mermaid": true,
"html_encoding": "UTF-8",
"preview_in_browser": true
}
插件配置项看似简单，但实际生效依赖顺序：先确保 Package Control 可用，再装对插件，最后调参数。最容易被跳过的一步是验证语言模式是否已切换为 Markdown —— 很多用户卡在“写了半天没高亮”，其实只是忘了点右下角手动切换。
