真正可用的只有markdownediting和markdownpreview两个插件，前者负责语法高亮、快捷键与语法识别，后者专司html生成与浏览器预览，二者分工明确；其他如markdownlivepreview、omnimarkuppreviewer等均存在停更、报错或渲染异常问题。

Sublime 里哪些 Markdown 插件真能用，哪些只是名字像

真正可用的只有 MarkdownEditing 和 MarkdownPreview 这两个，其他带 “Live”“Omni”“Editor” 字样的插件，要么已停更、要么在 ST4 下频繁报错（比如 AttributeError: 'NoneType' object has no attribute 'replace'），要么预览结果错乱（表格塌陷、图片路径 404）。

MarkdownEditing 只管高亮、快捷键、语法识别；MarkdownPreview 只管生成 HTML 并打开浏览器——两者分工明确，不重叠也不冲突。装完一个就以为能预览？那是错觉。

• 别碰 MarkdownLivePreview：2024 年后就没更新，ST4 启动直接抛异常
• 避开 OmniMarkupPreviewer：依赖老旧 markdown Python 库，遇到代码块嵌套或表格就渲染失败
• MarkdownEditing 的语法名必须是 Markdown GFM，不是右下角显示的 “Markdown” 或 “Markdown Extended”

右下角显示 Plain Text，但文件明明是 readme.md

这是最常见误操作：Sublime 没把当前文件识别为 Markdown，所有插件功能（快捷键、预览、高亮）全失效。根本原因不是插件没装，而是作用域（scope）没匹配上。

Markitdown Hosted Markdown Generator

MarkItDown 托管 Markdown 生成器：可将文件转换为 Markdown。支持 PDF、Word (.docx)、Excel (.xlsx/.xls)、PowerPoint (.pptx)、HTML、CSV、JSON、XML、图片等。

下载

• 点右下角文字 → 搜索 Markdown GFM → 选中（不是 Markdown）
• 之后点 View → Syntax → Open all with current extension as… → Markdown GFM，让所有 .md 文件默认走这个语法
• 如果点了没反应，检查是否被其他插件劫持了语法绑定（比如 Plain Text 被设为默认）
• 确认后按 Ctrl+Shift+P 输入 Markdown Preview: Preview in Browser，能执行才说明作用域生效

Ctrl+Alt+M 按了没反应，或者预览页面空白

快捷键失效或页面空白，90% 是因为 MarkdownPreview 没正确加载解析器，而不是浏览器或网络问题。

• 先运行 pip install markdown（确保是 Sublime 调用的 Python 环境，Windows 用户建议用 py -3 -m pip install markdown）
• 检查插件配置：Preferences → Package Settings → Markdown Preview → Settings 中，"enabled_parsers" 至少包含 "markdown"
• 预览空白时，打开浏览器开发者工具看 Console：若报 No parser named 'markdown'，就是上面 pip 没装对
• 若报 404，检查文件是否已保存（MarkdownPreview 不支持未保存文件预览）

想导出 PDF，但菜单项是灰色的

灰色 = 插件检测不到可用的 PDF 渲染工具。这不是插件 bug，是系统缺依赖。

• 必须手动安装 wkhtmltopdf（推荐），官网下载安装时勾选「Add to system PATH」
• macOS 用户确认 /usr/local/bin/wkhtmltopdf 在 $PATH 中；Windows 用户检查 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe 是否可执行
• 配置里 "pdf_converter": "wkhtmltopdf" 和 "enable_pdf_export": true 必须同时存在
• "wkhtmltopdf_path" 留空即可，填了反而容易因路径斜杠/空格出错

复杂点在于：PDF 输出质量几乎完全取决于你写的 CSS，插件只负责调用转换器。没配 CSS 的话，导出的就是纯白底黑字——这跟预览效果无关，得自己补样式。