如何安装Sublime Text 3 Markdown预览插件并使用教程？

本文共计904个文字，预计阅读时间需要4分钟。

完成+MarkdownPreview+但未预览、浏览器打开空白页、数学公式不渲染——>不是插件坏了，而是它根本未正确触发生成或依赖缺失。

Package Control 装没装好，直接决定后续全失败

很多人卡在第一步：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后搜不到 Package Control: Install Package。这不是网络慢，而是安装没生效。

• 必须用官方最新 Python 脚本安装，别手动拖文件进 Packages/Installed Packages/ 目录——放错位置或没重启都白搭
• 执行脚本后控制台要看到类似 Package Control: Installed 1 package 才算成功，之后必须重启 Sublime
• 国内用户如果一直卡在 Loading packages…，可尝试把脚本里 packagecontrol.io 换成 packagecontrol.cn，并同步更新哈希值（2026年已知有效）

MarkdownEditing 和 MarkdownPreview 必须一起装

MarkdownPreview 自己不负责语法高亮，也不识别 .md 文件——它只管“渲染”，而“识别”和“编辑”得靠 MarkdownEditing。

• 只装 MarkdownPreview：打开 .md 文件仍是白底黑字，右下角显示 Plain Text，预览命令压根不出现
• 只装 MarkdownEditing：能高亮、能快捷插入标题，但点 Markdown Preview: Preview in Browser 会报错 command not found: markdown_preview
• 装完两个后，务必点击右下角语言标识 → 选 MarkdownEditing → Markdown GFM，否则 GitHub 表格、任务列表等特性不生效

预览没反应？先查 Python 环境和 parser 配置

MarkdownPreview 默认调用系统 Python 解析 Markdown，不是 Sublime 内置的 Python。很多空白页或控制台报错都源于此。

• 控制台报 ImportError: No module named markdown：运行 pip install markdown（注意是系统 Python，不是 Sublime 自带的那个）
• 预览出来是纯文本而非 HTML：检查 Preferences → Package Settings → Markdown Preview → Settings，确认有 "parser": "github" 或 "github_mode": true
• 数学公式不显示：必须加 "enable_mathjax": true，且 parser 得设为 github 或 markdown，gfm 模式不支持 MathJax

快捷键和自动刷新得手动配，它不默认开

MarkdownPreview 默认没绑定快捷键，也不监听保存动作——所谓“实时预览”其实是假象，得自己补上。

• 加快捷键：进 Preferences → Key Bindings，右侧用户配置里加一行：

  [{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}]

• 启用自动刷新：在插件 Settings 里加 "enable_autoreload": true，但注意——只对已保存的本地文件有效，未保存或路径含中文会失效
• 浏览器打不开？别用 file:// 协议，改用 python -m http.server 8000 启服务，再在设置里配 "custom_browser": "http://localhost:8000/{file_path}"

最常被忽略的一点：所有配置项（比如 parser、github_mode、enable_mathjax）都必须写在 Markdown Preview → Settings – User 里，写在 Default 或其他地方无效；而且一旦用了 custom_browser，就别再指望 enable_autoreload 能正常工作。