Sublime Text 本身不支持 Markdown 预览，必须安装并正确配置 MarkdownPreview 插件；需确保语法识别为 Markdown、Python 环境≥3.6 且含 Pygments（或换用 mistune）、启用必要扩展，并配合 LiveReload 实现伪实时刷新。
预览根本不是 Sublime 自带功能，装完插件不等于能用
Sublime Text 本身对 Markdown 零预览支持，所谓“预览”全靠 MarkdownPreview 插件驱动。它不自动监听保存、不绑定快捷键、不默认渲染——装完重启后右键菜单里没选项、Ctrl+Shift+P 搜不到命令，是常态。
- 确认已通过 Package Control 安装的是
MarkdownPreview，不是MarkdownEditing（后者只管语法高亮） - 安装后必须重启 Sublime，否则命令不可见
- 打开
.md文件后，右下角状态栏必须显示Markdown，不是Plain Text；若显示错误，先Ctrl+Shift+P→ 输入Set Syntax: Markdown手动切换 - 别指望双击系统打开的 .md 文件能触发预览——Sublime 可能没拿到文件焦点，也未正确识别语法模式
浏览器预览失败？大概率卡在 Python 环境或 build system 冲突
MarkdownPreview 是个 Python 插件，所有转换逻辑都靠 Python 执行。它静默失败时，你只会看到空白页、404 或完全没反应，根本不会报错。
- 检查
python --version输出是否 ≥ 3.6；若用pyenv或conda，需在插件用户配置中显式指定python_binary路径 - 别手动设置 Tools → Build System → Python 或其他自定义 build system——这会劫持
Ctrl+B，而MarkdownPreview的命令面板入口（Ctrl+Shift+P→Markdown Preview: Preview in Browser）可能因此被抑制 - 恢复默认 build system：
Tools → Build System → Automatic - 首次触发必须走右键菜单或命令面板，不是保存就弹窗；
enable_autoreload设为true在新版中反而容易引发异常，建议保持false
样式丑、代码没高亮、中文锚点点不动？别硬改 CSS，先调 parser 和扩展
问题往往出在解析阶段：如果 tables、fenced_code、codehilite 这些扩展没启用，HTML 根本不生成对应结构，CSS 再漂亮也没用。
- 默认
parser是markdown（即 Python-Markdown），GFM 表格、任务列表、代码行号都不开箱即用；改用"parser": "mistune"更轻量且原生支持表格 - 若坚持用
markdown解析器，必须配全扩展："markdown_extensions": ["tables", "fenced_code", "codehilite", "toc"] -
codehilite依赖Pygments，报错No module named 'pygments'？说明你 Sublime 调用的 Python 环境没装它——此时换github或mistune更省事 - 中文标题锚点失效（如
[标题](#中文标题)点击跳转失败）？加这两项："html_preview": true和"enable_highlight": true——后者会顺带激活 URL 解码逻辑
想“实时”？别信“Live Preview in Browser”，真方案是 LiveReload + 手动绑定
MarkdownPreview 没有真正的实时刷新能力。“Live Preview in Browser” 选项只是名字唬人，实际仍是单次生成 HTML；所谓“实时”，得靠 LiveReload 插件监听文件变化并主动触发预览命令。
- 只装
LiveReload不够，它默认不认.md文件，也不调用markdown_preview - 进
Preferences → Package Settings → LiveReload → Settings – User，填入：{ "enabled_plugins": ["SimpleReloadPlugin"], "SimpleReloadPlugin": { "paths": ["*.md"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"} } } -
"command"必须是"markdown_preview"（小写+下划线），拼错就静默失败 - 浏览器端必须装官方 LiveReload 扩展（Chrome/Firefox 均有），并点击启用——否则只监听，不刷新
最常卡住的地方，从来不是插件装没装，而是语法识别没到位、parser 选错、或者把“按需快照”当成“Obsidian 式实时”。它本质是个稳定但需要手动点火的工具，别期待它自动为你思考。
