Sublime Text 本身不支持 Markdown 预览，必须安装 MarkdownPreview 插件并确保语法识别为 Markdown、Python ≥3.6 且配置正确 python_binary、首次手动触发 Preview in Browser 命令，三者缺一不可。
Sublime Text 本身不支持 Markdown 预览，装完插件 ≠ 能用；必须确保语法识别正确、Python 环境就位、首次手动触发预览，三者缺一不可。
为什么按 Ctrl+Shift+P 搜不到 Markdown Preview: Preview in Browser
命令面板里没这个选项，不是插件没装，而是启动链断在了前几步：
- 没重启 Sublime：Package Control 安装
MarkdownPreview后必须完全退出再重开，否则命令不注册 - 插件名拼错了：要装的是
MarkdownPreview（结尾是Preview），不是MarkdownEditing（只管高亮）、OmniMarkupPreviewer或LivePreview - Python 环境异常：插件底层靠 Python 解析 MD，若系统
python --version＜ 3.6，或用了pyenv/conda却没在Preferences → Package Settings → Markdown Preview → Settings中配python_binary，命令会静默消失
为什么右下角显示 Plain Text 而不是 Markdown
这是最常被忽略的拦路虎——它和插件无关，纯属 Sublime 自身语法绑定未生效：
- 点击右下角当前语法名（比如
Plain Text）→ 选Open all with current extension as…→ 找到并选中Markdown（Sublime 自带）或Markdown GFM（来自MarkdownEditing） - 若列表里没有
Markdown GFM，说明MarkdownEditing没装对或没重启；但仅预览需求，用自带Markdown就够了 - 别依赖双击系统打开的 .md 文件：Sublime 可能没拿到焦点，也未触发语法自动识别，建议直接在 Sublime 里
File → Open打开
为什么预览打开是空白页或图片不显示
这不是文件写错了，而是配置项没对齐，尤其容易栽在路径和协议上：
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 图片路径必须是相对路径，且以 .md 文件所在目录为基准，例如
；file://协议、绝对路径、../跨目录但没启http_server均会失败 -
"enable_autoreload": true在新版中反而易引发异常，官方推荐保持false；首次预览必须手动走命令面板或右键菜单，不能指望保存即刷新 - 中文锚点跳转失败？确认配置里开了
"html_preview": true和"enable_highlight": true，且文件编码是 UTF-8
怎么让预览支持数学公式和 Mermaid 图表
默认不启用，需显式打开对应扩展，且注意依赖关系：
- 数学公式：设
"enable_math": true，并确保"mathjax_enabled": true；MathJax CDN 若被墙，可换用本地 MathJax 或 KaTeX（需额外配mathjax_config） - Mermaid 图表：设
"mermaid": true，但 Mermaid 渲染依赖浏览器端 JS，需确认预览页面加载了mermaid.min.js；部分旧版 Mermaid 不兼容 Sublime 插件默认注入逻辑，建议用 v10+ 版本 - 所有扩展（如
fenced_code_blocks、tables）都通过"markdown_extensions"数组控制，漏配一个就可能让表格或代码块渲染异常
真正卡住人的从来不是“怎么装”，而是“为什么装了没反应”——重点盯住语法模式、Python 路径、首次手动触发这三点，其他都是配置微调。插件不会报错，它只会沉默地失败。
