markdownpreview装完没反应,90%因文件未被识别为markdown:必须保存为.md/.markdown后缀,右下角状态栏显示markdown gfm(需装markdownediting插件并设为该语法),否则插件完全不响应。

MarkdownPreview装完没反应?先看右下角是不是Markdown
插件装了但点预览没反应,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配置错了
默认"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
浏览器打开空白或报404?路径和Python环境在捣鬼
MarkdownPreview调的是系统Python,不是Sublime内置那个,也不走PATH,很多问题出在这儿。
将 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"(正斜杠,无引号) - 图片不显示?相对路径没问题,但
里的img/必须相对于.md文件所在目录,不是Sublime项目根目录 - 自动刷新失效?
"enable_autoreload": true只对已保存的本地文件有效,未保存或网络路径不触发
快捷键和导出HTML怎么配才真正“高精度”
默认没快捷键,也没导出功能——所谓“静态网页”得自己导出,不是浏览器里另存为。
- 加快捷键:进
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",用自定义模板控制样式
真正高精度,不在装得多,而在parser、encoding、browser、python_binary这四个点上全对齐;少一个,预览就掉一档精度。










