sublime Text 需装 markdownPreview 插件并正确配置才能实现 Markdown 预览：设对语法模式、保存文件、禁用 MathJax；避免 OmniMarkupPreviewer；关闭不可靠的自动刷新，推荐绑定 alt+m 快捷键。
sublime text 本身不带 Markdown 渲染预览功能，但装对插件、配好快捷键，就能实现「写即所见」的轻量体验——关键不是装插件，而是选对插件 + 避开默认配置的坑。
用 MarkdownPreview 而不是 OmniMarkupPreviewer
前者维护活跃、支持最新 Sublime 版本（4.x），后者已多年未更新，容易在 Sublime Text 4 中报 ImportError: No module named 'urllib2' 或直接无法启动预览。安装后默认绑定 ctrl+shift+P → Markdown Preview: Preview in Browser，但别急着点——它默认用 python 2 环境，而 ST4 默认走 Python 3，需手动修正。
- 打开
Preferences → Package Settings → MarkdownPreview → Settings - 在右侧面板添加：
{ "enabled_parsers": ["markdown"], "enable_highlight": true, "html_preview": true } - 若预览空白或报错，检查是否勾选了
"enable_mathjax"：MathJax CDN 已停服，开启会导致加载失败，建议设为false
ctrl+shift+P 预览没反应？检查文件语法和保存状态
Sublime 不会自动识别 .md 文件为 Markdown 语法，即使后缀正确，也常被识别成 Plain Text，导致插件不触发。这不是插件问题，是编辑器底层行为。
- 确认当前文件右下角显示的是
Markdown，不是Plain text：点击右下角文字 → 选Open all with current extension as… → Markdown - 预览前必须先保存文件（
ctrl+S），MarkdownPreview默认只处理磁盘上存在的文件，未保存的临时缓冲区内容不参与渲染 - 路径含中文或空格一般不影响，但若用网络路径（如
file:///C:/我的笔记/说明.md）预览失败，可尝试改用本地绝对路径格式（插件内部会 normalize）
想实时预览？别信「自动刷新」，用浏览器手动 F5 更稳
MarkdownPreview 的 "enable_autoreload" 选项在多数系统上不可靠：windows 下监听失效，macOS 偶发延迟，linux 可能因 inotify 限制漏事件。强行开启反而导致预览页卡死或重复弹窗。
- 关闭自动刷新：
"enable_autoreload": false - 写完一段后按
ctrl+shift+P→ 再输一遍Markdown Preview: Preview in Browser（第二次会复用已有标签页） - 更顺手的做法：给该命令绑个快捷键，在
Preferences → Key Bindings用户键位里加[ { "keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"} } ]
真正卡住人的往往不是插件装不上，而是文件没设对语法模式、没保存就点预览、或者开着 MathJax 等一个永远加载不完的 CDN。把这三件事盯住，剩下的就是写文档本身的事了。