sublime text 需配置语法识别、安装 markdownpreview 插件、设置自动刷新与 utf-8 编码、启用 pygments 高亮,才能正确识别 .md 文件、高效编辑、实时预览并导出带样式的 html。

Sublime Text 本身不内置 Markdown 渲染,但能高效写 Markdown——关键在装对插件、配好快捷键、避开预览陷阱。
怎么让 Sublime 正确识别 .md 文件
默认打开 .md 文件时,Sublime 可能用纯文本模式,没有语法高亮,也没有自动补全。这不是 bug,是没指定语法类型。
- 手动切换:右下角点击当前语法名(比如 “Plain Text”),选
Markdown或Markdown Extended - 自动绑定:进
Preferences → Settings – Syntax Specific,粘贴:{"extensions": ["md", "markdown"], "syntax": "Packages/Markdown/Markdown.sublime-syntax"} - 别用
MarkdownEditing插件的旧版语法路径(如Packages/MarkdownEditing/Markdown.tmLanguage),Sublime 4+ 已弃用.tmLanguage,会失效或报错
常用 Markdown 操作怎么快速输入
手敲 ### 标题 或 [链接](url) 太慢,Sublime 的 snippet 和快捷键才是效率核心。
- 内置 snippet:输入
h1+Tab→#,link+Tab→[text](url) - 推荐装
MarkdownPreview插件后,它自带更多 snippet(如img、list) - 别依赖鼠标点菜单插入链接——容易漏空格或括号错位;用
Ctrl+Shift+P调出命令面板,输Markdown: Insert Link更稳
实时预览为什么打不开或不刷新
MarkdownPreview 是最常用的预览插件,但它默认不自动刷新,且容易因路径或浏览器配置失败。
- 预览前先保存文件:
Ctrl+S,否则预览的是未保存内容(尤其粘贴大段文本后) - 首次预览失败?检查
Preferences → Package Settings → Markdown Preview → Settings中"browser": "chrome"是否匹配你实际安装的浏览器名(macOS 是"chrome",Windows 常要写"chrome.exe") - 改完 Markdown 不刷新?默认只支持保存后刷新;想实时响应,加配置:
"enable_autoreload": true
,但注意这会轻微增加 CPU 占用 - 别用系统自带的“预览”按钮(右上角小图标),它调用的是旧版
sublime-markdown-popups,不支持表格、脚注等新语法
导出 HTML 总是缺样式或乱码
直接用 MarkdownPreview: Save to HTML 导出,常遇到 CSS 不加载、中文变问号、代码块无高亮。
- 导出前确认设置了主题:
mdpopups主题或github主题更接近 GitHub 效果,配置项是"markdown_extensions"里的"mdpopups" - 中文乱码?在导出设置里加:
"encoding": "utf-8"
,并确保源文件本身是 UTF-8 编码(右下角看,不是 ANSI) - 代码块没高亮?
MarkdownPreview默认不启用 Pygments;需开启:"enable_highlight": true
,并确保系统已装 Python 和pygments(pip install pygments)
真正卡住人的往往不是不会装插件,而是导出 HTML 后发现样式丢了,或者改了一行标题,预览却还停在三分钟前——这些细节没对齐,整个流程就断在最后一步。










