Marked.js 解析器中的 Setext 标题特性解析

在 Markdown 语法解析过程中，Setext 标题是一种特殊的标题格式。与常见的 ATX 风格标题（使用 # 符号）不同，Setext 标题通过下划线字符（= 或 -）来定义标题级别。

Setext 标题的基本语法

Setext 标题由两部分组成：

1. 标题文本行（任意内容）
2. 下划线行（至少三个 = 或 - 字符）

示例：

一级标题
=======

二级标题
-------

常见误解场景

许多用户在使用数学表达式或分隔线时容易意外触发 Setext 标题解析，例如：

456
+456
------
912

这段内容会被解析为二级标题，因为中间的 ------ 被识别为 Setext 标题下划线。

解决方案

1. 使用代码块包裹

最简单的解决方案是将可能被误解析的内容放入代码块中：

```
456
+456
------
912
```

2. 禁用 Setext 标题解析

对于需要完全禁用 Setext 标题的场景，可以通过自定义 tokenizer 实现：

marked.use({
  tokenizer: {
    lheading() {} // 返回空即不解析为标题
  }
});

技术实现原理

在 Marked.js 的解析流程中，Setext 标题由专门的 lheading tokenizer 处理。当遇到符合 Setext 标题模式的内容时，解析器会生成相应的标题 token。通过覆盖这个 tokenizer 方法，开发者可以灵活控制是否启用这一特性。

最佳实践建议

1. 在包含大量连字符的内容时，优先考虑使用代码块
2. 数学表达式建议使用专门的数学公式语法（如 LaTeX）
3. 需要严格的内容控制时，考虑禁用 Setext 标题解析
4. 在文档中明确分隔线使用规范，避免与标题语法冲突