新建文件默认语法设为 markdown 必须在用户设置中配置 "default_syntax": "packages/markdownediting/markdown gfm.sublime-syntax",路径需完整、大小写正确且插件已安装;否则回退为 plain text。

新建文件默认语法设为 Markdown,必须手动配置 default_syntax 字段,且路径必须精确到 Packages/MarkdownEditing/Markdown GFM.sublime-syntax(不是系统自带的 Markdown)——否则高亮弱、表格不渲染、任务列表无样式。
为什么改了 Settings 还是 Plain Text?
Sublime 新建的 Untitled 文件默认走 default_syntax,但这个字段只在用户设置(User Settings)中生效,且值必须是完整、可加载的语法路径。常见失效原因:
- 写了
"default_syntax": "Markdown"或"Markdown"—— 这是无效字符串,Sublime 不识别 - 用了旧路径如
Packages/Markdown/Markdown.tmLanguage—— Sublime 4+ 已彻底弃用.tmLanguage,会静默忽略 - 路径大小写错误,比如
markdownediting(正确是MarkdownEditing) - 没装
MarkdownEditing插件,却直接引用其路径,导致语法加载失败,回退到 Plain Text
怎么拿到正确的 Markdown GFM 语法路径?
不能靠猜或复制网上的旧路径。正确方法是:打开一个已保存的 .md 文件 → 点右下角语法名 → 选 Open all with current extension as… → 找到并点击 MarkdownEditing/Markdown GFM。此时再执行 Tools → Developer → Show Scope Name,状态栏会显示 source.gfm。然后去 Packages/ 目录(Preferences → Browse Packages…)里找 MarkdownEditing/ 子目录,确认里面存在 Markdown GFM.sublime-syntax 文件。最终路径就是:
"default_syntax": "Packages/MarkdownEditing/Markdown GFM.sublime-syntax"
把这个加进 Preferences → Settings(右侧 User 面板)即可。
其他常用语法的 default_syntax 路径示例
所有路径都需以 Packages/ 开头,后缀必须是 .sublime-syntax,大小写敏感:
- Python:
Packages/Python/Python.sublime-syntax - JavaScript:
Packages/JavaScript/JavaScript.sublime-syntax - JSON:
Packages/JSON/JSON.sublime-syntax - YAML:
Packages/YAML/YAML.sublime-syntax - ShellScript:
Packages/ShellScript/Shell-Unix-Generic.sublime-syntax
注意:Shell-Unix-Generic 是 Sublime 4+ 中 Shell 的标准语法名,不是 ShellScript.sublime-syntax;YAML 路径里没有空格,别写成 YAML Syntax。
default_syntax 生效了,但新文件还是没代码块高亮?
这是因为 default_syntax 只控制初始语法和作用域,不自动启用插件的增强功能。比如 MarkdownEditing 的代码块语言识别、表格对齐、快捷键(如 Ctrl+Shift+M 插入列表)等,需要额外配置:
- 确保已安装
MarkdownEditing插件(通过 Package Control) - 打开
Preferences → Package Settings → MarkdownEditing → Settings – User,至少加一行:"parser": "gfm" - 如果想让新文件也支持自动换行、缩进等写作友好设置,可在同位置加:
"word_wrap": true, "draw_centered": false, "tab_size": 2
这些设置不会影响 default_syntax 本身,但决定了新建 Markdown 文件的实际编辑体验——很多人卡在这一步,以为“设了默认语法就万事大吉”,结果发现标题没颜色、代码块不着色,其实是插件层配置没跟上。











