Neovim切换配色方案后Tree-sitter无法高亮Markdown的问题

问题定位：配色方案未适配Tree-sitter #

核心问题是自带配色方案不支持Tree-sitter的语法高亮组，而非解析器问题：

• 初始状态下Kickstart.nvim的默认配色能正常高亮Markdown，说明Tree-sitter解析器工作正常；
• 切换到AppImage自带的传统配色（如default、desert等）后失效，是因为这些配色仅针对Vim原生正则高亮的语法组（如markdownHeading）设计，没有为Tree-sitter新增的@前缀高亮组（如@markup.heading.markdown）定义颜色；
• 设置additional_vim_regex_highlighting = true能恢复高亮，本质是让Vim同时启用原生正则高亮和Tree-sitter高亮，用旧高亮“补位”，但会造成重复计算。

验证方法 #

打开Markdown文件，切换到有问题的配色后：

1. 光标移到标题、加粗文本等元素，输入:Inspect，查看右侧显示的高亮组是否为@开头的Tree-sitter组；
2. 输入:hi @markup.heading.markdown（替换为刚才看到的组名），如果输出显示“xxx cleared”或颜色与默认背景/前景无差异，说明配色未适配该组。

解决方案 #

1. 替换为支持Tree-sitter的配色方案 #

弃用自带的老旧配色，选用专门适配Tree-sitter的现代主题，常见的有：

• Catppuccin：覆盖绝大多数语言和Tree-sitter语法组，风格多样
• Tokyonight：Kickstart.nvim默认主题之一，对Markdown及Hugo前置YAML支持完善
• Dracula：经典深色主题，更新后全面支持Tree-sitter
• Gruvbox Material：Gruvbox改良版，适配Tree-sitter高亮
• Nord：简约冷色调主题，支持Tree-sitter

2. 临时适配现有配色（不换主题） #

如果不想更换配色，可以手动让Tree-sitter的Markdown/YAML高亮组继承原生正则高亮的颜色，在init.lua中添加以下配置：

vim.api.nvim_create_autocmd("ColorScheme", {
  pattern = "*",
  callback = function()
    -- 映射Tree-sitter Markdown组到原生高亮组
    vim.cmd("hi link @markup.heading.markdown markdownHeading")
    vim.cmd("hi link @markup.italic.markdown markdownItalic")
    vim.cmd("hi link @markup.bold.markdown markdownBold")
    vim.cmd("hi link @markup.list.item.markdown markdownListMarker")
    vim.cmd("hi link @markup.link.text.markdown markdownLinkText")
    -- 适配Hugo的YAML前置内容
    vim.cmd("hi link @yaml.key.yaml yamlKey")
    vim.cmd("hi link @yaml.value.yaml yamlValue")
  end,
})

这样切换配色后，Tree-sitter的高亮组会自动复用原生Markdown/YAML的颜色定义，无需开启额外正则高亮。

内容的提问来源于stack exchange，提问作者badbishop