Sublime Text 实时预览Markdown需安装持续维护的MarkdownPreview插件，配合Package Control、UTF-8编码、已保存的.md文件及正确语法识别；启用enable_autoreload需搭配LiveReload扩展或Live Preview命令才能实现自动刷新，数学公式和Mermaid需手动开启对应配置。
Sublime Text 本身不渲染 Markdown，所谓“实时预览”必须靠插件补足，且没有真正意义上的侧边内嵌实时预览——所有方案都依赖浏览器打开 HTML 页面，保存后手动刷新或加额外配置才能自动更新。
装哪个插件？只认 MarkdownPreview
别搜 Markdown Preview（带空格）、MarkdownEditing 或 OmniMarkupPreviewer：MarkdownPreview 是目前唯一持续维护、明确支持 Sublime Text 4、自带浏览器调用和基础数学公式支持的插件。其他插件要么已停更，要么只管语法高亮（如 MarkdownEditing），要么和 MarkdownPreview 冲突导致右键菜单消失或快捷键失效。
- 安装前先确认已装
Package Control；没装就按Ctrl+`调出控制台，粘贴官网最新安装代码（注意 2026 年起部分旧哈希校验已失效，务必用 packagecontrol.io 当前页提供的代码） - 装完
MarkdownPreview后必须重启 Sublime，否则Ctrl+Shift+P里搜不到命令 - 重启后打开一个
.md文件，右下角状态栏必须显示Markdown（不是Plain text），否则插件不触发
Markdown Preview: Preview in Browser 没反应？先查这四点
常见现象是命令面板能搜到、点了却没反应，甚至菜单灰掉——大概率不是插件坏了，而是运行环境没对齐：
- 文件没保存：插件默认只处理已保存的
.md文件，新建未存的 tab 无法预览 - 编码不是 UTF-8：含中文路径或中文内容时，若文件编码为 GBK 或其它，预览会报错或空白，
File → Reopen with Encoding → UTF-8再试 - Python 环境异常：Sublime 自带 Python，但某些精简版或 macOS M1 安装包可能缺
html.parser模块，控制台输import html.parser验证 - 快捷键绑定失效：默认快捷键
Ctrl+Alt+M（Windows/Linux）仅在text.html.markdown作用域生效，如果语法没切对，它就完全不响应
怎么让保存后浏览器自动刷新？配 "enable_autoreload": true 不够
只在 Preferences → Package Settings → Markdown Preview → Settings – User 里加 "enable_autoreload": true，浏览器不会自己刷新——它只是让插件监听文件变化，实际刷新还得靠浏览器端配合：
- 首次必须手动执行一次
Markdown Preview: Preview in Browser，之后保存才会触发监听 - Chrome / Edge 用户需安装 LiveReload 扩展，并在扩展设置中启用“Allow access to file URLs”
- Firefox 用户得手动在预览页面地址栏输入
javascript:document.write('<script src="%5C%22http://localhost:35729/livereload.js%5C%22"></script>')注入脚本（不推荐，稳定性差） - 更稳的替代法：用
Markdown Preview: Live Preview in Browser命令（不是默认快捷键），它会启动一个本地 HTTP 服务，绕过浏览器 file:// 协议限制，自动刷新成功率更高
公式、图表、自定义 CSS 怎么开？别漏关键开关
MarkdownPreview 默认禁用数学公式和 Mermaid 图表，即使你写了 $$E=mc^2$$ 或 ```mermaid 也不会渲染：
- 公式支持要开两个：配置里加
"enable_math": true和"mathjax_enabled": true（后者决定是否加载 MathJax CDN） - Mermaid 支持需额外设
"enable_mermaid": true，并确保浏览器能访问https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js - 自定义 CSS 路径必须写相对路径（如
"css": ["./custom.css"]），且该 CSS 文件得和当前.md在同一目录，绝对路径或上级目录引用基本失败 - GitHub 风格渲染不是默认项，要显式设
"parser": "github"，否则表格对齐、任务列表等会退化成标准 CommonMark 行为
最易被忽略的一点：所有配置项都只在 Settings – User 里生效，Settings – Default 是只读的，改了也没用；另外每次改完配置最好重启 Sublime，避免缓存导致新选项不加载。
