必须同时安装MarkdownEditing和MarkdownPreview插件，前者负责语法识别与高亮（右下角选Markdown GFM），后者负责渲染；单独安装任一插件均无法正常预览，且所有配置须写入Settings – User文件中。
装完 MarkdownPreview 却点不预览、浏览器打开空白页、数学公式不渲染——不是插件坏了，而是它根本没被正确触发或依赖缺失。
Package Control 装没装好，直接决定后续全失败
很多人卡在第一步：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后搜不到 Package Control: Install Package。这不是网络慢，而是安装没生效。
- 必须用官方最新 Python 脚本安装，别手动拖文件进
Packages/Installed Packages/目录——放错位置或没重启都白搭 - 执行脚本后控制台要看到类似
Package Control: Installed 1 package才算成功，之后必须重启 Sublime - 国内用户如果一直卡在
Loading packages…，可尝试把脚本里packagecontrol.io换成packagecontrol.cn，并同步更新哈希值（2026年已知有效）
MarkdownEditing 和 MarkdownPreview 必须一起装
MarkdownPreview 自己不负责语法高亮，也不识别 .md 文件——它只管“渲染”，而“识别”和“编辑”得靠 MarkdownEditing。
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
- 只装
MarkdownPreview：打开.md文件仍是白底黑字，右下角显示Plain Text，预览命令压根不出现 - 只装
MarkdownEditing：能高亮、能快捷插入标题，但点Markdown Preview: Preview in Browser会报错command not found: markdown_preview - 装完两个后，务必点击右下角语言标识 → 选
MarkdownEditing → Markdown GFM，否则 GitHub 表格、任务列表等特性不生效
预览没反应？先查 Python 环境和 parser 配置
MarkdownPreview 默认调用系统 Python 解析 Markdown，不是 Sublime 内置的 Python。很多空白页或控制台报错都源于此。
- 控制台报
ImportError: No module named markdown：运行pip install markdown（注意是系统 Python，不是 Sublime 自带的那个） - 预览出来是纯文本而非 HTML：检查
Preferences → Package Settings → Markdown Preview → Settings，确认有"parser": "github"或"github_mode": true - 数学公式不显示：必须加
"enable_mathjax": true，且parser得设为github或markdown，gfm模式不支持 MathJax
快捷键和自动刷新得手动配，它不默认开
MarkdownPreview 默认没绑定快捷键，也不监听保存动作——所谓“实时预览”其实是假象，得自己补上。
- 加快捷键：进
Preferences → Key Bindings，右侧用户配置里加一行：[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}] - 启用自动刷新：在插件 Settings 里加
"enable_autoreload": true，但注意——只对已保存的本地文件有效，未保存或路径含中文会失效 - 浏览器打不开？别用
file://协议，改用python -m http.server 8000启服务，再在设置里配"custom_browser": "http://localhost:8000/{file_path}"
最常被忽略的一点：所有配置项（比如 parser、github_mode、enable_mathjax）都必须写在 Markdown Preview → Settings – User 里，写在 Default 或其他地方无效；而且一旦用了 custom_browser，就别再指望 enable_autoreload 能正常工作。
