必须同时安装MarkdownEditing和MarkdownPreview插件，缺一不可；前者负责语法识别与高亮，后者负责HTML预览，且需手动将.md文件绑定为Markdown GFM语法并重启Sublime。
必须同时装 MarkdownEditing 和 MarkdownPreview，缺一不可；只装一个，预览命令不出现、语法不识别、点开空白页，都是正常现象。
Package Control 装没装好，后续全白搭
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调出命令面板，输入 Package Control: Install Package。如果命令灰色、无响应或根本搜不到，说明 Package Control 没生效。
- 别拖文件进
Packages/目录——放错位置或没重启都不行 - 用官方 Python 3 安装脚本（2026 年最新哈希值为
6f4c264a24d933ce70df5dedcf1dcaee ebe013ee18cced0ef93d5f746d80ef60），粘贴进控制台（Ctrl+`）后回车 - 看到
Package Control: Installed 1 package输出后，必须完全退出 Sublime 再重开 - 国内用户若卡在
Loading packages…，可把脚本中packagecontrol.io替换为packagecontrol.cn，并同步更新哈希值
安装 MarkdownPreview 和 MarkdownEditing 的关键细节
MarkdownPreview 必须拼写严格：M 和 P 大写、中间无空格、结尾是 Preview（不是 Previewer，也不是 Markdown Preview 带空格）。搜错名字、装错插件，会导致命令面板有条目但点不动、右键菜单消失、甚至 Sublime 崩溃。
- 重启后再次呼出命令面板 → 输入
Package Control: Install Package→ 等列表加载完成（5–10 秒，别急着输）→ 输入MarkdownPreview→ 回车 - 同理再装
MarkdownEditing（它不负责渲染，只管语法识别和高亮） - 装完两个插件后，必须完全退出 Sublime 再重开——否则
markdown_preview命令不会注册到系统里 - 验证是否成功：打开一个
.md文件 →Ctrl+Shift+P→ 输入Markdown Preview，能看到Markdown Preview: Preview in Browser才算到位
预览失败的常见原因和对应操作
点了命令却弹空白页、404、乱码或报 command not found: markdown_preview，问题几乎都不在插件本身，而在环境配置。
- 右下角状态栏必须显示
Markdown或Markdown GFM（点击它 → 搜索选中），否则插件静默不响应——插件根本不看文件名，只认当前语法模式 - 文件必须已保存为
.md或.markdown后缀；未保存的untitled标签永远无法触发预览 - 文件编码必须是
UTF-8（不是UTF-8 with BOM），含中文内容时GBK会直接中断解析 - 路径不能含中文或空格（如
C:\我的文档\readme.md会失败），临时解法是移到D:\md\这类纯英文路径 - 浏览器调用失败常见于 Chrome 不在系统 PATH，可在
Preferences → Package Settings → Markdown Preview → Settings – User中写死路径："browser": "C:/Chrome/chrome.exe"（注意斜杠方向）或设为"browser": "default"
数学公式、表格、自动刷新这些功能怎么开
默认配置下，$$公式不渲染、GitHub 表格错位、保存后浏览器不刷新——不是插件缺陷，是默认关闭了对应模块。
- 数学公式需加两项：
"enable_mathjax": true+ 把"parser"设为"github"或"markdown"（gfm模式不支持 MathJax） - 表格、脚注等扩展需在
"markdown_extensions"里显式加入"extra"（不是默认开启） -
"enable_autoreload": true在 2026 年已废弃：ST4 上启用会导致保存瞬间卡死甚至崩溃；所谓“实时”，其实是浏览器端 reload 的结果，前提是首次手动执行过Preview in Browser，且浏览器标签保持打开、URL 是file://或http://127.0.0.1开头 - 快捷键要自己配：进
Preferences → Key Bindings，右侧用户配置加一行，例如：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
最容易被忽略的是：右下角语法模式必须手动设为 Markdown 或 Markdown GFM，哪怕文件名是 readme.md；还有就是 enable_autoreload 已失效，现在靠的是浏览器自身 reload 机制，不是插件在后台推 HTML。
