必须重启sublime text且文件绑定为markdown语法，否则ctrl+shift+p搜不到markdown preview命令；未保存的.md文件、右下角显示plain text、误装markdownediting等均会导致命令不可见。
Ctrl+Shift+P搜不到 Markdown Preview 命令？重启 + 文件绑定缺一不可
插件装完不出现命令，90% 是因为没重启 Sublime Text。Package Control 安装后，markdown_preview 命令不会热加载，必须完全退出再启动。
即使重启了，命令仍不出现，检查这三点：
- 文件是否已保存为
.md或.markdown后缀（未保存的untitled标签页不触发） - 右下角状态栏是否显示
Markdown（不是Plain Text；点它 →Open all with current extension as…→Markdown） - 是否误装了
OmniMarkupPreviewer或仅装了MarkdownEditing（后者只管高亮，不提供预览命令）
验证命令是否注册：按 Ctrl+` 打开控制台，输入 sublime.list_commands()，搜索 "markdown_preview" 是否在返回列表里。
预览打开空白页或 404？路径、编码、解析器三者联动出错
空白页 ≠ 插件崩溃，而是 HTML 生成失败或浏览器加载失败。常见组合问题：
- Windows 下路径含中文或空格（如
C:\我的文档\readme.md）→ 浏览器 URL 解码失败，报 404；改用纯英文路径（如C:\md\readme.md） - 文件编码不是
UTF-8（右下角点编码名 → 强制选UTF-8；带 BOM 的 UTF-8 会导致html.parser解析中断） - 配置中
"parser": "github"但网络不通或没配 token → 卡住无响应；改用离线可用的"parser": "mistune"或"parser": "markdown"
浏览器打不开？检查设置里 "browser" 字段：留空时依赖系统 PATH；若 Chrome 没加进环境变量，会静默失败——可显式写成 "browser": "chrome"（macOS/Linux）或 "browser": "C:\Program Files\Google\Chrome\Application\chrome.exe"（Windows）。
表格/代码块/删除线不渲染？默认解析器不支持 GFM 特性
不是 CSS 没加载，是 HTML 根本没生成对应结构。默认 "parser": "markdown" 只支持基础 CommonMark，GFM 扩展需手动启用：
- 表格、任务列表、脚注 → 改用
"parser": "mistune"（无需联网，支持tables、strikethrough、tasklist） - 目录（TOC）、代码高亮、脚注 → 在设置中加
"enabled_extensions"，例如：["extra", "codehilite", "toc", "fenced_code", "tables"] - 数学公式 → 必须同时设
"enable_mathjax": true且 parser 不能是"gfm"（它不支持 MathJax）
注意："parser": "github" 虽支持全部 GFM，但需联网 + GitHub token，国内不稳定；"mistune" 是更可靠的离线替代方案。
为什么 Ctrl+S 保存后不自动刷新？autoreload 默认开但依赖正确触发
"enable_autoreload": true 是默认值，但自动刷新只在以下条件满足时生效：
- 预览窗口是通过
Markdown Preview: Preview in Browser命令打开的（双击生成的临时 HTML 文件无效） - 浏览器标签页没被手动关闭（关闭后需重新触发命令）
- 文件保存动作发生在 Sublime 内（外部编辑器改保存不触发）
如果仍不刷新，检查控制台是否有 WebSocket 连接错误——某些杀毒软件或防火墙会拦截 Sublime 的本地服务端口（默认 8080），可改用 "server_port": 8081 避开。
真正容易被忽略的是：预览依赖 Sublime 自带的 Python 3.8+ 运行时（ST4 Build 4143+），旧版 ST3 或手动替换过 python38.dll 的用户，import markdown 会静默失败，连带 autoreload 失效。
