Markdown Preview 插件无反应主因是Python环境未匹配或配置错误：需确认系统Python≥3.6、启用autoreload、正确设置python_binary；渲染问题应切换Pygments解析器并配置markdown_extensions；中文锚点失效需开启html_preview和enable_highlight并确保UTF-8编码。
Markdown Preview 插件装完没反应？检查 Python 环境和插件状态
Sublime Text 本身不内置 Markdown 实时预览，必须靠 Markdown Preview 插件实现。但装完常没反应，不是插件问题，而是它依赖系统 Python（3.6+），且默认不自动启用浏览器预览。
- 打开 Sublime →
Preferences → Package Settings → Markdown Preview → Settings，确认"enable_autoreload": true已开启 - 在终端运行
python --version，确保输出 ≥3.6；若用 pyenv 或 conda，需把对应python路径写进插件配置的"python_binary"字段 - 右键 Markdown 文件 →
Markdown Preview → Preview in Browser才是首次触发方式，别指望保存就自动弹窗
预览样式丑、代码块不亮色？改用内置 Pygments 渲染器
默认用 GitHub API 渲染，样式固定、代码无高亮、离线失效。切到本地 Pygments 就能自定义 CSS、支持主题、完全离线。
- 安装 Pygments：
pip install Pygments（注意：必须和 Sublime 调用的python是同一个环境） - 在
Markdown Preview的用户配置中设："parser": "markdown"+"markdown_extensions": ["fenced_code", "codehilite"] - 把自定义 CSS 放进
Markdown Preview/css/custom.css（路径在插件设置里有提示），比如加pre { font-size: 14px; }控制代码块大小
Ctrl+B 编译失败报错“command not found: markdown”？别乱配 build system
有人想用 Sublime 的 Build System 直接跑 markdown 命令生成 HTML，但系统根本没这个命令——那是老式 Perl 脚本，早淘汰了。真要编译，得走插件接口，不是 shell。
Markdown Docs Full-Text Search
下载
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索，适用于需要快速、高效搜索大量 Markdown 文章的场景。
- 删掉自己建的
Markdown.sublime-build文件，它和Markdown Preview冲突 - 正确做法：用快捷键
ctrl+shift+p→ 输入Markdown Preview: Export HTML，导出静态文件 - 如果非要终端编译，用
python -m markdown -x codehilite input.md -o output.html，而不是幻想存在一个全局markdown命令
中文目录锚点乱码、跳转失效？URL 编码必须开
用 [标题](#中文标题) 写链接时，浏览器地址栏显示 %E4%B8%AD%E6%96%87 这种编码，但 Sublime 的预览服务默认不 decode，导致点击后找不到锚点。
- 在
Markdown Preview配置里加上："html_preview": true和"enable_highlight": true（高亮会顺带激活 URL 解码逻辑） - 确保 Markdown 文件保存为 UTF-8 编码（右下角看，不是 GBK）
- 如果仍跳转失败，临时方案：把标题改成英文 ID，用
{#my-section}语法手动指定锚点，绕过中文编码问题
最常被忽略的是 Python 环境和插件渲染器的耦合关系——换 Python 版本、切 conda env、重装系统后，Markdown Preview 很可能就静默罢工，不是插件坏了，是它连不上那个 python 进程。
