Marked.js 中 HTML 标签与 Markdown 标题的解析问题解析

在 Marked.js 这个流行的 Markdown 解析库中，HTML 标签与 Markdown 语法之间的交互一直是一个需要特别注意的问题。最近在版本升级过程中，用户发现了一个关于 <br> 标签与 Markdown 标题解析行为的改变，这实际上反映了 Markdown 解析规范中的一个重要原则。

问题现象

当用户在 Marked.js 14.0.0 升级到 15.0.11 版本后发现，以下 Markdown 代码的解析结果发生了变化：

### Test1
- <a href="#" target="_blank">Link1</a>
<br>
### Test2
- <a href="#" target="_blank">Link1</a>

在新版本中，<br> 标签后的 ### Test2 不再被正确解析为 H3 标题，而是直接显示为文本。而有趣的是，如果使用 </br> 替代 <br>，标题又能被正确解析。

技术背景解析

这个行为变化源于 Marked.js 对 CommonMark 规范的更好兼容。在 Markdown 解析中，HTML 块级元素会打断连续的 Markdown 结构解析，这是符合规范的预期行为。

HTML 块级标签（即使是像 <br> 这样的单标签）会创建一个独立的 HTML 块，根据 CommonMark 规范，这会中断之前的 Markdown 上下文（如列表、段落等），导致后续的 Markdown 语法需要重新开始解析。

正确的写法

规范的 Markdown 写法应该在不同结构之间使用空行进行分隔：

### Test1

- <a href="#" target="_blank">Link1</a>

<br>

### Test2

- <a href="#" target="_blank">Link1</a>

这种写法在任何版本的 Marked.js 中都能得到一致的解析结果，因为它明确分隔了不同的结构块。

关于 </br> 的特殊情况

</br> 不是标准的 HTML 标签写法（<br> 是自闭合标签，不需要闭合标签），它能够工作实际上是解析器的一个意外行为。在规范的实现中，这种非标准写法不应该被特别处理，Marked.js 未来版本可能会修正这个不一致性。

给开发者的建议

1. 遵循标准的 Markdown 格式规范，在不同结构间使用空行
2. 避免依赖 HTML 标签与 Markdown 语法的紧邻写法
3. 升级 Markdown 解析库时，注意测试 HTML 与 Markdown 混合内容
4. 了解 CommonMark 规范，它正成为 Markdown 解析的事实标准

这个案例很好地展示了为什么遵循 Markdown 的格式规范如此重要，特别是在混合使用 HTML 和 Markdown 语法时。规范的写法不仅能保证解析的一致性，也能使文档在不同渲染环境下都能正确显示。