装对插件、设对语法、保存为.md文件三者缺一不可，否则预览永不触发；必须右下角显示Markdown、文件已保存且后缀为.md、重启Sublime后安装MarkdownPreview插件，缺一即失效。
装对插件、设对语法、保存为 .md 文件，三者缺一不可，否则预览永远不出现。
为什么 Markdown Preview 命令点了没反应？
不是插件坏了，是它根本没被触发——MarkdownPreview 只在满足全部条件时才工作：
- 文件右下角状态栏必须显示
Markdown（不是Plain Text、Markdown GFM或其他变体）；点击状态栏文字 → 搜索并选中Markdown - 文件必须已保存，且后缀为
.md；新建未命名的untitled标签页，哪怕内容全是 Markdown，也完全无视 - 安装后必须彻底退出 Sublime Text 再重开；只靠
Ctrl+Shift+P重载插件或刷新缓存无效 - 别装错名字：
MarkdownEditing只管高亮和快捷键，OmniMarkupPreviewer已多年未维护，与 ST4 冲突严重；唯一有效的是MarkdownPreview（结尾是Preview，无空格、无s、非Previewer）
图片不显示、公式乱码、表格崩了怎么办？
问题通常不出在 Markdown 写法，而在解析器和路径配置：
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 中文乱码 → 确保右下角编码为
UTF-8；选错成GBK或Western (ISO 8859-1)会导致解析中断，页面空白 - 图片路径失效 →
MarkdownPreview默认不启动本地 HTTP 服务，这类相对路径在浏览器直接打开时会被跨域拦截；解决办法：用file://协议配合根相对路径（如），或改用github解析器（需 token） - 数学公式（
$$...$$）、Mermaid 图表默认不启用 → 必须手动在MarkdownPreview.sublime-settings中开启："enable_math": true和"enable_mermaid": true - 表格/删除线/任务列表不渲染 → 默认
"parser": "markdown"不支持 GFM 特性；换"parser": "github"（推荐）或"parser": "mistune"，避免硬配markdown_extensions导致依赖缺失（比如codehilite需 Pygments，但 Sublime 自带 Python 环境通常没装）
怎么让保存后自动刷新浏览器页面？
这不是监听文件变化，而是“保存后重载已打开的预览页”——关键在两处设置：
- 确保
"enable_autoreload": true已写入用户设置（默认开启，但若被覆盖就失效） - 首次预览必须用命令
Markdown Preview: Preview in Browser手动触发；之后再按Ctrl+S才会自动刷新，否则只是保存，不触发重载 - 如果仍不刷新，检查是否误设了非默认 Build System（如 Tools → Build System → Python），切回
Automatic；MarkdownPreview依赖 Sublime 内置 Python，外部 Python 环境异常会导致静默失败 - 追求更可靠刷新？可额外装
LiveReload插件，启用Simple Reload with delay (400ms)，但它不是必需项，多数场景enable_autoreload足够
导出 HTML 文件 vs 浏览器预览，参数怎么填？
都走同一个命令 markdown_preview，区别全在 args：
- 仅预览（默认行为）：
{"target": "browser"}或不传args - 导出 HTML 到磁盘：
{"target": "disk", "parser": "github"}；生成文件与原.md同目录，同名 +.html后缀 - 复制 HTML 到剪贴板：
{"target": "clipboard"}；适合粘贴进邮件或 CMS - 快捷键绑定示例（Preferences → Key Bindings）：
{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
导出时图片路径不会自动修正，仍需确保源文件中用的是浏览器可读的相对路径；若含绝对路径或网络资源，导出后可能断链。
