必须安装拼写严格的markdownpreview（m和p大写、无空格、无s），配合markdownediting才能实现完整功能；装错插件或未正确设置语法模式（右下角须显示markdown）、未保存为.md文件、编码非utf-8、路径含中文/空格、浏览器调用失败等均会导致预览失效。
装哪个插件？只认 MarkdownPreview，别拼错、别装错
命令面板里搜到 Markdown Preview（带空格）或 OmniMarkupPreviewer，都是无效的。真正起作用的只有拼写严格为 MarkdownPreview 的那个——M 和 P 大写，结尾是 Preview，不是 Previewer，中间无空格、无 s。
装错的后果很直接：命令面板能看见条目但点不动，右键菜单消失，保存卡顿，甚至 Sublime 崩溃。尤其 MarkdownEditing 只管语法高亮和快捷键，完全不生成 HTML；OmniMarkupPreviewer 已多年未维护，与 ST4 冲突严重。
- 用
Package Control: Install Package安装时，必须输入MarkdownPreview精确匹配 - 安装完必须完全退出 Sublime Text（不只是关闭窗口），再重新打开，否则命令不会注册
- 重启后按
Ctrl+Shift+P，输入mp，应能看到Markdown Preview: Preview in Browser
文件没反应？先看右下角是不是 Markdown，不是就白装
插件根本不看文件名，只认当前视图的语法模式。哪怕你打开的是 readme.md，右下角显示 Plain text，MarkdownPreview 就彻底静默——这不是 bug，是设计逻辑。
- 点击右下角状态栏文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 新建未保存的 tab（如
untitled）永远无法触发预览，必须先Ctrl+S保存为.md或.markdown后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown
预览打不开 / 页面空白？编码、路径、浏览器三者必查
常见现象是点击命令后浏览器一闪而过、页面空白、报 404 或乱码，问题几乎都出在本地环境，而非插件本身。
- 文件编码必须是
UTF-8：右下角点编码名 → 选UTF-8（避免UTF-8 with BOM）；含中文内容时，GBK 编码会导致解析中断 - 路径别含中文或空格：比如
C:我的文档 est.md很可能失败，改用C:md est.md - 浏览器调用失败常因 Chrome 不在系统 PATH；可在
Preferences → Package Settings → Markdown Preview → Settings – User中写死路径："browser": "C:\Program Files\Google\Chrome\Application\chrome.exe"（Windows）或"browser": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"（macOS）
“实时刷新”不是开个开关就行，得手动触发 + 浏览器配合
"enable_autoreload": true 在 2026 年已不是“开关”，而是监听前提。设它为 true 却不满足条件，反而会让 Sublime 保存时卡住甚至崩溃。
- 首次必须手动执行一次
Markdown Preview: Preview in Browser，之后保存才会触发监听 - 浏览器标签页 URL 必须是
file://或http://127.0.0.1开头；http://localhost可能因端口冲突失败 - Chrome / Edge 用户需安装
LiveReload扩展，并在设置中启用Allow access to file URLs；同时关闭chrome://settings/privacy里的「使用预测服务来加载网页」，否则本地文件刷新常被拦截
最容易被忽略的其实是第一次手动预览——没这一步，后续所有自动刷新配置都等于没配。很多人反复改设置、重装插件，却忘了点一下那个命令。
