sublime text 本身不支持 markdown 实时预览，必须通过 markdownpreview 插件配合浏览器实现；默认为手动模式，需先手动执行一次“preview in browser”，再配置 "enable_autoreload": true 并确保浏览器以 file:// 或 http://127.0.0.1 打开，才能实现保存后自动刷新。
Sublime Text 本身不支持 Markdown 实时预览，所谓“实时”必须靠 MarkdownPreview 插件 + 浏览器配合实现；装错插件、开错配置、路径含中文或没手动触发首次预览，90% 的失败都发生在这几步。
为什么装了 MarkdownPreview 还不能自动刷新？
MarkdownPreview 默认是手动模式：你按一次 Markdown Preview: Preview in Browser，它才生成 HTML 并打开浏览器；之后改文件、保存，页面不会自己动。所谓“实时”，其实是靠配置 "enable_autoreload": true 让插件在保存后向已打开的浏览器标签页发刷新指令——但这个功能有硬性前提：
- 必须先手动执行一次预览（否则没有目标标签页可刷新）
- 浏览器必须用
file://或http://127.0.0.1打开，http://localhost有时会因端口冲突失败 - Chrome/Edge 要关掉
chrome://settings/privacy里的“使用预测服务来加载网页”，否则本地文件刷新常被拦截 -
"enable_autoreload": true在 macOS 上搭配 Safari 容易失焦，建议固定用 Chrome 并配"browser": "chrome"
LiveReload 插件到底起不起作用？
Sublime 里装任何叫 LiveReload 的插件基本没用——它们要么只适配 ST3、要么根本没注入刷新逻辑。真正起效的是独立运行的 livereload CLI 命令 + 浏览器扩展组合：
- 先装 CLI：
npm install -g livereload - 项目根目录运行：
livereload . --port 35729 --exts html,css,js,md（漏掉md就不会响应 Markdown 修改） - 浏览器必须装官方 LiveReload 扩展（图标是黑白靶心），且右下角显示
LiveReload is connected - 网页必须用
http://localhost:35729打开，file://协议下扩展被禁用，连不上 WebSocket - 如果控制台报
WebSocket connection to 'ws://localhost:35729/livereload' failed，先用lsof -i :35729（macOS/Linux）或netstat -ano | findstr :35729（Windows）查端口是否被占
预览空白、公式不渲染、表格错位怎么办？
这些不是插件坏了，而是解析器和扩展没对齐：
- 文件后缀必须是
.md（不是.markdown或.txt），且右下角状态栏显示Markdown语法（点一下手动切过去） - 数学公式要生效，得在
MarkdownPreview.sublime-settings里加"enable_math": true，且确保没开"parser": "github"（GitHub API 离线不可用） - 表格、代码块高亮依赖
Pygments，需系统级安装：pip install pygments，再配"enable_pygments": true - 路径含中文或空格时，Chrome 可能打不开
file://页面，此时应改用http-server起临时服务：npx http-server -c-1，然后访问http://127.0.0.1:8080 - 别同时装
MarkdownPreview和OmniMarkupPreviewer，二者冲突会导致快捷键失效、右键菜单消失
最常被忽略的一点：所有“实时”效果都建立在「首次预览成功」的基础上。很多人卡在第一步——没手动执行过 Markdown Preview: Preview in Browser，就去调配置、装扩展、改端口，结果全是白忙。
