sublime text 本身不支持 markdown 实时预览，必须通过 markdownpreview 插件配合浏览器模拟实现；需确保文件语法识别为 markdown、首次手动触发预览、保存后才可自动刷新，且插件安装后必须重启 sublime。
Sublime Text 本身不支持 Markdown 实时预览，所谓“实时”必须靠 MarkdownPreview 插件 + 浏览器配合模拟；装错插件、语法未设为 Markdown、没手动触发首次预览，这三步出错，90% 的失败就发生了。
怎么确认当前文件被识别为 Markdown？
右下角状态栏显示什么，Sublime 就按什么语法处理文件——哪怕文件名是 readme.md，如果那里写着 Plain text，MarkdownPreview 就不会响应任何命令。
- 点击右下角文字 → 搜索
Markdown→ 选中Markdown（不是Markdown GFM或其他变体） - 想一劳永逸？打开一个
.md文件后，右下角点击 →Open all with current extension as…→Markdown - 未保存的临时文件（如
untitled）永远无法触发预览，务必先Ctrl+S保存为.md后缀
为什么装了 MarkdownPreview 却找不到命令？
常见原因不是插件没装好，而是 Sublime 没重启，或装了冲突插件（比如同时有 OmniMarkupPreviewer 或旧版 Markdown Preview）。
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
- 安装完
MarkdownPreview后必须完全退出 Sublime 再重开，否则Ctrl+Shift+P里搜不到命令 - 用
Ctrl+`打开控制台，输入import sys; print(sys.version)，确认输出 Python 版本 ≥3.3（ST4 自带3.8+，无需额外装 Python） - 别碰
enable_autoreload：该配置项已在新版MarkdownPreview中废弃，强行写入会导致自动刷新失效
怎样让保存后浏览器自动刷新？
它不是“保存就刷新”，而是“先手动打开一次预览页，之后保存才触发刷新”——这个前提漏掉，所有配置都白搭。
- 首次必须手动执行：
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车 - 浏览器会以
file://协议打开 HTML 页面；若 URL 是http://localhost:xxxx或含中文路径，自动刷新大概率失败 - 刷新依赖浏览器原生能力，不用装 LiveReload 扩展，也不用改
mathjax_enabled等参数来启用基础刷新 - 快捷键可自定义：在
Preferences → Key Bindings里加一行{"keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"}}
哪些效果本来就不该渲染？
别把 Sublime 当 Typora 或 Obsidian——MarkdownPreview 渲染的是标准 CommonMark + GitHub Flavored Markdown 子集，很多“所见即所得”特性它压根不支持。
-
<details><summary></summary></details>标签、自定义 CSS、部分内联 HTML 属性（如style="color:red"）默认不生效 - 表格对齐仅靠空格/制表符无法渲染，必须用合法的 GFM 表格语法（
|---|分隔线） - 数学公式需显式启用：
"enable_math": true，且页面加载时必须联网访问 MathJax CDN（离线环境会空白）
最常被忽略的一点：自动刷新只作用于已打开的预览标签页，如果你关掉它再保存，下次还得手动触发；也没法跨浏览器同步，Chrome 打开的页面，Edge 不会跟着刷。
