装完 MarkdownPreview 插件后必须重启 Sublime Text，否则命令未注册；文件须保存为 .md/.markdown 后缀、语法模式设为 Markdown、路径避免中文和空格，解析器需配置 GFM 扩展或改用 mistune 才支持表格等特性。
装完 MarkdownPreview 插件后，不重启 Sublime、不保存为 .md 后缀、不切到 Markdown 语法模式，预览命令就根本不会出现——这不是 bug，是设计逻辑。
为什么 Ctrl+Shift+P 里搜不到 Markdown Preview？
插件安装后必须重启 Sublime Text，否则命令未注册进命令面板。常见误操作是装完立刻试，结果搜不到任何 MarkdownPreview 相关命令。
- 确认右下角状态栏显示的是
Markdown，不是Plain Text；点它 →Open all with current extension as…→Markdown - 文件必须已保存，且后缀为
.md或.markdown；untitled标签页不触发预览 - 检查是否误装了
MarkdownEditing（只管高亮）或OmniMarkupPreviewer（配置逻辑完全不同），它们和MarkdownPreview不兼容 - 如果重启后仍不可见，在控制台（
Ctrl+`）输入sublime.list_commands()，搜索markdown_preview是否在返回列表中
预览打开空白页或报 404 怎么办？
空白页 ≠ 插件坏了，大概率是解析中断或资源加载失败。最常被忽略的是编码和路径问题。
- 右下角点击编码名（如
UTF-8 with BOM），强制设为UTF-8；中文乱码会导致html.parser解析失败，页面直接空 - Windows 用户避免中文路径或空格路径，比如
C:\我的文档\test.md很可能失败；改用C:\md\test.md - 浏览器打不开？检查设置里
"browser"字段是否写死路径；默认值为空时依赖系统PATH，Chrome 若没加进环境变量就会静默失败 - 预览 HTML 中 CSS/JS 加载不了？别双击临时 HTML 文件——必须通过插件命令（
Preview in Browser）打开，它走的是 Sublime 的本地服务代理
表格不渲染、代码块没高亮、删除线失效？
不是 CSS 没生效，是解析器压根没生成对应 HTML 结构。默认 "parser": "markdown" 只支持基础语法。
- 启用 GFM 特性：把设置里的
"parser"改成"github"（需联网 + GitHub token）或更轻量的"mistune"（离线可用，支持表格、任务列表） - 若坚持用
markdown解析器，必须显式开启扩展："markdown_extensions": ["tables", "fenced_code", "codehilite", "toc"] -
codehilite依赖 Pygments，而 Sublime 自带 Python 通常没装它；此时换解析器比硬配codehilite更可靠 - 数学公式默认关闭，要启用需加
"enable_math": true，并确保 MathJax CDN 可访问（离线场景建议用 KaTeX 配置）
想“实时刷新”但改完还得手动按快捷键？
MarkdownPreview 本身没有实时机制，所谓“自动刷新”是三端协同结果：Sublime 触发生成、浏览器监听变更、LiveReload 注入脚本——缺一不可。
- 先在设置里开
"enable_autoreload": true - 浏览器装 LiveReload 扩展（Chrome/Firefox 均有），并点击图标启用监听
- 确保预览 HTML 页面里注入了 LiveReload 脚本；插件默认会加，但如果用了自定义
css或template，可能被覆盖 - 快捷键
Ctrl+Alt+M默认只在text.html.markdown作用域生效；如果语法没识别对，快捷键完全不响应
真正容易被忽略的是作用域和路径约束：它不处理未保存文件、不兼容中文路径、不接管双击 HTML 的行为——这些不是缺陷，而是它作为“轻量渲染工具”的边界。
