sublime text 的 markdown 预览完全依赖第三方插件（如 markdownpreview），非自带功能；需手动安装、重启、确认语法模式、配置 python 环境与构建系统，并正确设置解析器和路径方案。
Sublime Text 里 Markdown 预览根本不是插件自带功能
Sublime Text 本身不提供实时 HTML 预览，所谓“Markdown 预览”全靠第三方插件实现，最常用的是 MarkdownPreview。它不自动启动预览，也不绑定快捷键——装完等于没用，必须手动配置。
常见错误现象：Ctrl+Shift+P 调出命令面板后搜不到 Markdown Preview；或者点了命令没反应；又或者预览打开的是空白页或 404。
- 确认已通过 Package Control 安装
MarkdownPreview，不是MarkdownEditing（后者只管语法高亮） - 安装后需重启 Sublime，否则命令不可见
- 确保当前文件后缀是
.md或.markdown，且右下角状态栏显示 “Markdown” 语法模式
预览命令不生效？检查 Python 环境和 build system 冲突
MarkdownPreview 依赖 Python 执行转换逻辑，如果 Sublime 的 Python 环境异常（比如被其他插件污染、或系统 Python 升级后路径失效），就会静默失败。
另一个高频原因：你手动设置了 Tools → Build System → Python 或其他自定义 build system，导致 Ctrl+B 被占用，而部分用户误以为预览该用 Ctrl+B。
- 恢复默认 build system：
Tools → Build System → Automatic - 预览固定用命令面板：
Ctrl+Shift+P→ 输入Markdown Preview→ 回车 - 想改快捷键？编辑
Preferences → Key Bindings，添加类似这样的映射：[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"}}]
生成的 HTML 样式丑 / 不支持表格/代码块？别硬调 CSS，先看 parser 和 markdown_extensions
默认用的是 Python-Markdown 解析器，它对 GitHub Flavored Markdown（GFM）支持有限：表格、任务列表、脚注默认不启用，代码块也没行号和语言高亮。
不是 CSS 文件没加载对，而是解析阶段就没生成对应 HTML 结构。
- 在
Preferences → Package Settings → Markdown Preview → Settings中，把"parser"改成"github"（需配好 GitHub token）或"mistune"（轻量但支持 GFM 表格） - 若坚持用
markdownparser，务必开启扩展："markdown_extensions": ["tables", "fenced_code", "codehilite", "toc"]
-
codehilite依赖 Pygments，若报错No module named 'pygments'，说明 Sublime 自带 Python 没装它——此时换用github或mistune更省事
本地图片不显示？路径别写相对 URL，用 file:// 协议或配置 enable_autoreload
Markdown 里写 ，预览时图片 404，不是路径错，是浏览器同源策略拦截了 file:// 协议下的相对资源加载。
这不是 bug，是现代浏览器安全限制。强行用绝对 file:// 路径也容易因空格、中文、编码问题失效。
- 最稳方案：启用
"enable_autoreload": true，它会起一个本地 HTTP server（http://127.0.0.1:8080），绕过 file:// 限制 - 次选：把图片路径写成
，但每次换机器都要改，不实用 - 注意：
enable_autoreload启动后首次预览会慢 1–2 秒，别误判为卡死
Sublime 的 Markdown 预览链路长、依赖多，每个环节都可能断：语法识别 → 插件加载 → Python 解析 → HTML 生成 → 浏览器加载。最容易被忽略的是「文件是否被正确识别为 Markdown」和「build system 是否意外覆盖了命令通道」。
