sublime text 正确识别 .md 文件需两步:先临时设置语法为 markdown,再在 syntax specific 设置中添加 "extensions": ["md", "markdown"] 实现永久关联。

怎么让 Sublime Text 正确识别 .md 文件
Sublime 默认不把 .md 当 Markdown,而是当成纯文本或其它类型,导致没语法高亮、没预览、代码块也不折叠。根本原因是文件关联没设对。
操作很简单:打开任意一个 .md 文件 → 点击右下角当前语法标识(比如显示 “Plain Text”)→ 选 Markdown → 再点一次右下角 → 选 Set Syntax: Markdown。这步只是临时生效。
要永久生效,得改用户设置:
- 菜单栏 Preferences → Settings – Syntax Specific
- 在打开的右侧窗口里加一行:
"extensions": ["md", "markdown"] - 保存后,所有同名后缀文件自动匹配 Markdown 语法
注意:别手误写成 extension(少个 s),否则无效;也别加 .txt 这类干扰后缀,否则可能误伤其它文件类型。
用什么插件能实时预览 Markdown
Sublime 原生不支持预览,必须靠插件。最稳定的是 MarkdownPreview,不是 MarkdownEditing(它只管编辑体验)。
安装后默认快捷键是 ctrl+shift+P(Windows/Linux)或 cmd+shift+P(macOS)→ 输入 Markdown Preview: Preview in Browser → 回车。页面会在浏览器打开,且支持自动刷新。
- 首次使用前建议检查 Python 路径:插件依赖 Python 2.7 或 3.6+,如果报错
No module named 'html.parser',说明 Python 版本太低或路径不对 - 预览默认用 GitHub 风格渲染,想换样式?改用户配置里的
"parser": "github"为"markdown"或"gitlab" - 别开太多预览页——它不会复用已有标签页,每次都是新窗口,容易卡顿
为什么代码块缩进失效或高亮错乱
常见现象:写完 ```python 后,后续行没缩进提示,或者关键字没变色。这不是插件问题,是 Sublime 的嵌入语法机制没加载全。
MarkdownPreview 和 MarkdownEditing 都依赖 Sublime 自带的 Python、JavaScript 等语言包来高亮代码块。如果对应语言包被禁用或损坏,就会失效。
- 检查路径:
Packages/Python/Python.sublime-syntax是否存在(通过 Preferences → Browse Packages… 进入) - 如果缺失,重装
Package Control或手动恢复对应语言包 - 别在 Markdown 文件里直接粘贴带全角空格或制表符混用的代码——Sublime 对缩进敏感,会误判代码块边界
导出 HTML 或 PDF 总失败怎么办
MarkdownPreview 支持导出,但默认不启用本地 HTML 保存,也不带 PDF 功能。PDF 必须额外装 wkhtmltopdf 并配置路径,稍有不慎就报错 Command not found: wkhtmltopdf。
更现实的做法是导出 HTML 后用浏览器另存为 PDF(打印 → 保存为 PDF),兼容性更好。
- 导出 HTML:快捷键
ctrl+shift+P→Markdown Preview: Save to HTML - 确保配置里
"enable_autoreload_on_save": true是开启的,否则保存后 HTML 不更新 - 如果导出内容缺 CSS 样式,检查配置中
"css": []是否为空——空数组会跳过样式注入,得填绝对路径或留默认值
真正麻烦的不是操作步骤,是路径权限和空格。比如 wkhtmltopdf 装在 C:\Program Files\ 下,Sublime 读取时容易因空格截断。绕开办法:用短路径(PROGRA~1)或装到无空格目录。











