在markdown.nvim中禁用Setext标题渲染的解决方案

问题背景

在使用markdown.nvim插件时，用户遇到了一个特殊场景：当编写嵌套列表项时，某些特定格式的文本会被错误地识别为Setext标题（一种Markdown二级标题语法，使用下划线=或-表示）。例如以下内容：

- test:
  - 

会被错误地渲染为Setext标题，导致显示异常和光标跳转问题。

技术分析

Setext标题是Markdown标准语法的一部分，其识别规则由tree-sitter-markdown解析器实现。当文本行以-开头且满足特定条件时，解析器会将其识别为Setext标题而非列表项。

markdown.nvim作为渲染插件，默认会遵循解析器的语法树结构进行渲染。虽然用户希望仅禁用特定字符触发的Setext标题渲染，但从技术实现角度，这需要修改底层解析规则，而非简单的渲染层调整。

解决方案

1. 完全禁用Setext标题渲染

markdown.nvim在0.10.0版本后新增了配置选项，允许全局禁用Setext标题的渲染：

opts = {
  heading = {
    setext = false,  -- 禁用Setext标题渲染
  },
}

此方案简单有效，但会完全禁用所有Setext标题的渲染效果。

2. 自定义语法高亮

对于需要保留部分Setext标题功能但调整特定场景显示的用户，可以通过覆盖tree-sitter的高亮规则实现：

1. 创建高亮规则文件：<config_root>/queries/markdown/highlights.scm
2. 基于默认规则移除Setext相关部分
3. 自定义特定语法节点的高亮样式

示例规则片段：

(setext_heading
  (paragraph) @custom.setex.heading.2
  (setext_h2_underline) @custom.setex.underline.2)

然后定义对应的highlight组：

highlight link custom.setex.heading.2 MarkdownListMarker
highlight link custom.setex.underline.2 MarkdownListMarker

3. 输入法优化

为避免语法冲突，可以：

1. 使用+代替-作为列表标记
2. 配置快捷键自动插入优化后的列表格式：

vim.api.nvim_buf_set_keymap(0, 'i', ';', '<End>:<CR><TAB>+ ', { noremap = true })

技术限制

需要注意的是，上述方案仅能解决渲染层问题，无法改变底层解析器的语法识别逻辑。这意味着：

• 被识别为Setext标题的文本仍不会被视为列表项
• 某些高级功能（如列表图标渲染）可能受限

总结

markdown.nvim提供了灵活的配置选项来处理Setext标题渲染问题。根据实际需求，用户可以选择：

• 简单粗暴地全局禁用
• 精细调整高亮规则
• 优化输入方式避免冲突

对于大多数用户，方案1已能满足需求；而需要保留Setext标题功能的用户，则可以考虑方案2的自定义高亮方法。