Marked.js 15.0版本中HTML换行符与Markdown标题的解析行为变更解析

在Marked.js从14.0升级到15.0版本后，开发者发现了一个值得注意的解析行为变化：当HTML换行标签<br>直接出现在Markdown标题语法###之前时，标题将无法被正确解析。这个变化源于项目对CommonMark规范的进一步兼容，属于有意为之的设计调整，但其中也暴露出一些值得开发者关注的细节。

问题现象深度分析

在14.0版本中，以下Markdown结构能够正常解析：

### 标题1
- 列表项
<br>
### 标题2

但在15.0.11版本中，第二个### 标题2会被原样输出而非转换为<h3>标签。有趣的是，使用非标准闭合标签</br>时却能意外地保持旧版行为，这实际上揭示了底层解析逻辑的一个边界情况。

技术背景解析

这个行为变更源于Marked.js对CommonMark规范的更严格实现。根据规范：

1. HTML块级元素规则：像<br>这样的标签会终止前续内容的解析上下文（如列表），需要显式的空行来重新建立新的Markdown块级元素上下文。

2. 空白行要求：Markdown规范建议在任何块级元素（标题、列表、代码块等）之间使用空行分隔，这是保证解析可靠性的最佳实践。

正确的写法规范

开发者应该遵循以下格式：

### 标题1

- 列表项

<br>

### 标题2

关键要点：

• 在HTML标签前后保留空行
• 避免依赖非标准HTML标签（如</br>）
• 列表与标题之间需要明确的上下文分隔

版本兼容性建议

对于需要升级的项目：

1. 全面检查文档中HTML与Markdown混合使用的部分
2. 使用Marked.js的迁移指南进行验证
3. 考虑添加Markdown lint工具确保格式规范

这个案例很好地展示了Markdown解析器在严格模式与宽松模式之间的平衡取舍，也提醒开发者遵循规范的书写习惯的重要性。