Markdown Preview插件安装后不生效，需确认Sublime Text为ST4（自带Python 3.8+）、Package Control已更新、右下角语法显示Markdown、文件已保存为.md；渲染器应设为"markdown"并启用"extra"等扩展，禁用中文路径或配置"enable_autoreload": false。
Markdown Preview插件安装后不生效？检查Python环境和插件依赖
Sublime Text默认不带Python 3.8+运行时，而Markdown Preview从3.0版起强制要求Python 3.8+。如果你用的是Sublime Text 4（Build 4143+），它自带Python 3.8，但旧版ST3或手动替换过python38.dll的用户常卡在这一步。
验证方法：打开Sublime控制台（Ctrl+`），输入import sys; print(sys.version)，输出低于3.8.0就必然失败。
- ST3用户请升级到ST4，ST3官方已停止维护，且无法兼容新版
Markdown Preview - 不要手动复制系统Python的
python38.dll进Sublime目录——路径冲突会导致插件加载静默失败 - 确认Package Control已更新：菜单
Tools → Command Palette → Package Control: Upgrade Package Control
预览快捷键无效或弹出空白页？检查配置项和渲染后端
默认快捷键Ctrl+Shift+P调出命令面板后输入Markdown Preview，选Preview in Browser，但很多人点了没反应，其实是后端没配对。
Markdown Preview支持三种渲染器：github（需联网）、markdown（本地解析）、gitlab（少用）。若配置为github但网络不通，就会卡住或返回空页，且无错误提示。
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 打开
Preferences → Package Settings → Markdown Preview → Settings - 确保
"markdown_extensions"里包含"extra"（否则表格、脚注等不渲染） - 把
"renderer"显式设为"markdown"，避免依赖外部服务 - 如需数学公式，加
"pymdownx.arithmatex"到markdown_extensions，并启用"enable_mathjax": true
中文路径下预览报错“File not found”？路径编码和URL转义是关键
Windows下用中文路径保存.md文件，点击预览常跳出浏览器404，错误日志里显示类似file:///C:/Users/张三/.../文档/笔记.md被截断成%E5%BC%A0%E4%B8%89后无法识别——这是Sublime内部URL编码与浏览器解码不一致导致的。
- 临时解法：把文件移到纯英文路径下（如
D:/md/），验证是否为路径问题 - 根治方式：在Settings里添加
"enable_autoreload": false，禁用自动重载可绕过部分编码异常 - 更稳妥的做法是改用
LiveReload+BrowserSync组合，但需额外装Node.js和CLI工具，适合长期写作者
样式丑、字体小、代码块没高亮？别改CSS文件，直接覆盖用户配置
很多人去翻Markdown Preview插件目录下的mdpreview.css硬改，结果一升级插件就被覆盖。正确做法是用用户级CSS覆盖机制。
- 新建文件
Preferences → Package Settings → Markdown Preview → Markdown Preview Custom CSS - 在里面写CSS，例如：
code { font-size: 0.95em; background: #f6f6f6; } body { font-family: "Microsoft YaHei", sans-serif; } - 代码块高亮依赖
highlight.js主题，可在Settings里设"highlight_style": "github-gist"，支持的值见插件文档的highlight_styles列表 - 注意：自定义CSS不支持
@import，所有样式必须内联写死
最常被忽略的是渲染器选择和Python版本绑定关系——不是所有“能装上”的插件都能跑起来，尤其在多Python环境共存的机器上。建议先跑通renderer: "markdown"本地模式，再逐步加功能。
