Sublime Text 4 实时预览 Markdown 依赖 MarkdownPreview 插件与浏览器协同，须装对插件、首次手动预览、文件保存为 .md 且语法识别为 Markdown、编码为 UTF-8；"enable_autoreload": true 已废弃，启用反致卡死。
Sublime Text 4 本身不支持 Markdown 实时预览，所谓“实时”是靠 MarkdownPreview 插件 + 浏览器自动重载模拟出来的效果；装错插件、跳过首次手动预览、忽略浏览器策略，三者任一都会让预览失败。
只装 MarkdownPreview，别碰 MarkdownEditing 或 OmniMarkupPreviewer
很多人搜 “markdownpreview” 装了名字相近的插件，结果命令面板里有条目、点了没反应——MarkdownEditing 只负责语法高亮和快捷键，完全不生成 HTML；OmniMarkupPreviewer 已多年未维护，与 ST4 冲突频发，常导致右键菜单消失或保存卡死。
- 用
Package Control: Install Package安装时，必须输入MarkdownPreview（带大写 M 和 P，无空格、无 s、不是Previewer） - 安装后必须完全退出 Sublime Text 再重开，否则
Ctrl+Shift+P搜不到Markdown Preview: Preview in Browser - 确认已启用：打开命令面板，输入
mp，能看到且能执行该命令
文件必须被识别为 Markdown 语法，不是靠文件名
哪怕你打开的是 readme.md，只要右下角状态栏显示 Plain text，MarkdownPreview 就彻底静默——这不是 bug，是设计逻辑。
- 点击右下角状态栏文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 新建未保存的 tab（如
untitled）永远无法触发预览，务必先Ctrl+S保存为.md后缀 - 想一劳永逸？保存后右下角点击 →
Open all with current extension as…→Markdown -
Ctrl+Alt+M默认只在text.html.markdown作用域生效，语法不对，快捷键就等于不存在
"enable_autoreload": true 在 2026 年起已废弃，设为 true 反而会卡死
很多老教程说加 "enable_autoreload": true 就能“实时”，这是过时信息。新版里强行写入不仅无效，还会导致 Sublime 在保存瞬间卡住甚至崩溃（尤其 ST4 + Windows）。
- 真正起作用的是浏览器端的自动重载机制：首次手动执行一次
Markdown Preview: Preview in Browser，之后只要保持该标签页 URL 是file://或http://127.0.0.1:开头，保存即刷新 - Chrome/Edge 用户需关闭设置里的「使用预测服务来加载网页」（
chrome://settings/privacy），否则本地文件刷新常被拦截 - 数学公式和 Mermaid 图表需手动启用对应配置项，比如
"mathjax_enabled": true，默认不开启
中文路径和 UTF-8 编码是硬性前提
含中文路径或中文内容时，若文件编码为 GBK 或其它，预览会报错或空白。
-
File → Reopen with Encoding → UTF-8再试 - Sublime Text 4 自带 Python 3.8+，一般不用额外装；但若控制台运行
import sys; print(sys.version)报错或版本低于 3.3，说明环境异常，需重装官方版 - 首次使用前建议执行一次
Markdown Preview: Preview in Browser命令，插件会自动下载并缓存Pygments、Markdown等依赖
容易被忽略的地方是：首次手动预览这一步不可跳过，它不只是“看一眼”，而是建立监听目标标签页的必要动作；浏览器 URL 必须以 file:// 或 http://127.0.0.1: 开头，http://localhost 有时因端口冲突失败。
