Sublime Text 3安装Markdown预览插件教程-sublime-PHP中文网

必须同时安装markdownediting和markdownpreview插件，前者负责语法识别与高亮（右下角选markdown gfm），后者负责渲染；单独安装任一插件均无法正常预览，且所有配置须写入settings – user文件中。

sublime text 3安装markdown预览插件教程

装完 MarkdownPreview 却点不预览、浏览器打开空白页、数学公式不渲染——不是插件坏了，而是它根本没被正确触发或依赖缺失。

Package Control 装没装好，直接决定后续全失败

很多人卡在第一步：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）后搜不到 Package Control: Install Package。这不是网络慢，而是安装没生效。

必须用官方最新 Python 脚本安装，别手动拖文件进 Packages/Installed Packages/ 目录——放错位置或没重启都白搭
执行脚本后控制台要看到类似 Package Control: Installed 1 package 才算成功，之后必须重启 Sublime
国内用户如果一直卡在 Loading packages…，可尝试把脚本里 packagecontrol.io 换成 packagecontrol.cn，并同步更新哈希值（2026年已知有效）

MarkdownEditing 和 MarkdownPreview 必须一起装

MarkdownPreview 自己不负责语法高亮，也不识别 .md 文件——它只管“渲染”，而“识别”和“编辑”得靠 MarkdownEditing。

Markdown Converter 1.0.0

使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。

下载

只装 MarkdownPreview：打开 .md 文件仍是白底黑字，右下角显示 Plain Text，预览命令压根不出现
只装 MarkdownEditing：能高亮、能快捷插入标题，但点 Markdown Preview: Preview in Browser 会报错 command not found: markdown_preview
装完两个后，务必点击右下角语言标识 → 选 MarkdownEditing → Markdown GFM，否则 GitHub 表格、任务列表等特性不生效

预览没反应？先查 Python 环境和 parser 配置

MarkdownPreview 默认调用系统 Python 解析 Markdown，不是 Sublime 内置的 Python。很多空白页或控制台报错都源于此。

控制台报 ImportError: No module named markdown：运行 pip install markdown（注意是系统 Python，不是 Sublime 自带的那个）
预览出来是纯文本而非 HTML：检查 Preferences → Package Settings → Markdown Preview → Settings，确认有 "parser": "github" 或 "github_mode": true
数学公式不显示：必须加 "enable_mathjax": true，且 parser 得设为 github 或 markdown，gfm 模式不支持 MathJax

快捷键和自动刷新得手动配，它不默认开

MarkdownPreview 默认没绑定快捷键，也不监听保存动作——所谓“实时预览”其实是假象，得自己补上。

加快捷键：进 Preferences → Key Bindings，右侧用户配置里加一行：

[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}]

启用自动刷新：在插件 Settings 里加 "enable_autoreload": true，但注意——只对已保存的本地文件有效，未保存或路径含中文会失效
浏览器打不开？别用 file:// 协议，改用 python -m http.server 8000 启服务，再在设置里配 "custom_browser": "http://localhost:8000/{file_path}"

最常被忽略的一点：所有配置项（比如 parser、github_mode、enable_mathjax）都必须写在 Markdown Preview → Settings – User 里，写在 Default 或其他地方无效；而且一旦用了 custom_browser，就别再指望 enable_autoreload 能正常工作。