sublime如何安装Markdown插件_sublime编写Markdown环境搭建【详解】

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 —— 很多用户卡在“写了半天没高亮”，其实只是忘了点右下角手动切换。