Milkdown项目中的列表项首元素限制问题解析

在Milkdown编辑器的preset-commonmark预设中，存在一个值得注意的设计选择：列表项（list item）的首个元素必须为段落（paragraph）类型。这个限制与CommonMark规范存在差异，也影响了用户的部分编辑体验。

问题现象

当用户尝试在列表项中直接插入块引用（blockquote）或代码块（codeblock）等非段落块级元素作为首元素时，编辑器会自动插入一个空段落。例如：

1. 输入以下Markdown内容时：

   1. > 块引用内容
   

   编辑器会自动转换为：

   1. 
      > 块引用内容
   

2. 类似地，尝试将代码块作为列表项首元素也会遇到相同限制。

技术背景

在ProseMirror架构中，节点Schema定义了每个节点允许包含的内容结构。Milkdown的list-item节点当前定义为：

content: 'paragraph block*'

这种设计强制要求首个子元素必须是paragraph类型，后面可以跟随任意数量的其他块级元素。这与CommonMark规范中允许任何块级元素作为列表项首元素的设计存在差异。

潜在解决方案

通过修改Schema定义可以解除这个限制：

content: 'block+'

这种修改理论上可行，因为：

1. 完全符合CommonMark规范
2. 实际测试表明编辑器仍能正常工作
3. 不会破坏现有的文档结构

设计考量

虽然技术上可行，但原始设计可能有以下考虑：

1. 保持编辑体验的一致性
2. 简化光标定位和选区处理
3. 避免潜在的渲染或布局问题
4. 与某些Markdown方言保持兼容

对用户的影响

当前限制可能导致：

1. 不符合CommonMark规范的意外行为
2. 从其他编辑器迁移内容时出现差异
3. 某些特定排版需求难以实现

结论

这个问题反映了Markdown实现中规范遵循与用户体验之间的平衡。虽然技术上可以通过修改Schema来解决，但需要全面评估对现有功能的影响。对于需要严格遵循CommonMark规范的用户，可以考虑通过自定义Schema来覆盖预设行为。

对于大多数用户而言，了解这个限制并适应在列表项开头使用段落元素是最简单的解决方案。而对于有特殊需求的用户，则可以通过扩展机制来自定义列表项的行为。