Sublime Text安装MarkdownPreview高精度转换静态网页

大宇姑娘_8305

发布时间：2026-08-18 09:18:26

559人浏览过

来源于php中文网

原创

MarkdownPreview装完没反应，90%因文件未被识别为Markdown：必须保存为.md/.markdown后缀，右下角状态栏显示Markdown GFM（需装MarkdownEditing插件并设为该语法），否则插件完全不响应。

sublime text安装markdownpreview高精度转换静态网页

插件装了但点预览没反应，90%是因为Sublime根本没把当前文件识别为Markdown。它不看内容，只认后缀和语法设置。

文件必须已保存，且后缀是.md或.markdown（.MD在Windows/macOS部分版本下不生效）
右下角状态栏必须显示Markdown GFM（不是Plain Text，也不是Markdown裸名）——点击状态栏语言名 → 选MarkdownEditing → Markdown GFM
如果没这个选项，说明MarkdownEditing插件没装，或者装了但被Sublime自带的Markdown包冲突屏蔽了：进Preferences → Package Settings → Markdown → Settings – User，写入{"ignored_packages": ["Markdown"]}并重启

默认"parser": "markdown"只支持基础语法，GFM特性（任务列表、表格、删除线）和数学公式全挂掉。高精度转换必须换解析器。

要GitHub风格完整渲染（含表格、任务列表、代码块高亮），设"parser": "github"；注意：需申请GitHub token填入github_oauth_token字段，否则部分API限流会降级
不想配token又想要GFM，改用"parser": "mistune"（轻量、快、支持大部分GFM，但不支持MathJax）
数学公式必须开"enable_mathjax": true，且parser不能是gfm——这个模式压根不加载MathJax，只认github或markdown
中文乱码/空白页？确认文件编码是UTF-8（右下角点编码名 → 选UTF-8），别用UTF-8 with BOM

MarkdownPreview调的是系统Python，不是Sublime内置那个，也不走PATH，很多问题出在这儿。

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

ImportError: No module named markdown：运行pip install markdown（确保是系统Python，不是Anaconda或虚拟环境里的）
Chrome打不开、报Permission denied：Windows用户尤其常见，路径含空格或中文时失败。设"browser": "default"最稳；非要指定Chrome，路径写成"C:/Program Files/Google/Chrome/Application/chrome.exe"（正斜杠，无引号）
图片不显示？相对路径没问题，但![alt](img/logo.png)里的img/必须相对于.md文件所在目录，不是Sublime项目根目录
自动刷新失效？"enable_autoreload": true只对已保存的本地文件有效，未保存或网络路径不触发

默认没快捷键，也没导出功能——所谓“静态网页”得自己导出，不是浏览器里另存为。

加快捷键：进Preferences → Key Bindings（右侧用户配置），贴这行：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
导出静态HTML：命令面板输Markdown Preview: Export HTML in Sublime Text，生成的HTML带内联CSS和MathJax，可直接发给他人查看
想换主题？别动preview_theme，它只影响Sublime内部预览窗；对外部浏览器起效的是github_css（true/false）和custom_css（填绝对路径.css文件）
导出的HTML里字体小、排版挤？在Settings – User里加"html_template": "/path/to/your/template.html"，用自定义模板控制样式