Typst中段落与列表元素的层级关系解析

在Typst排版系统中，段落(paragraph)与列表(list)作为两种基础内容元素，存在着明确的层级关系约束。本文将通过一个典型场景分析这种层级关系的设计原理，并提供正确的实现方案。

问题现象分析

当开发者尝试在par函数内直接包含列表项时，会发现列表内容无法正常显示。这是因为Typst 0.13版本开始强化了内容模型的层级约束：

#par(spacing: 2em, leading: 2em)[
  show
  - not show  // 该列表项会被忽略
]

系统会明确提示"block may not occur inside of a paragraph"，即块级元素不能出现在段落内部。

设计原理

Typst的内容模型遵循以下核心原则：

1. 段落级元素：处理连续文本流，支持行间距(leading)和段落间距(spacing)控制
2. 块级元素：包括列表、图片、表格等需要独立布局的组件
3. 层级约束：块级元素不能嵌套在段落内部，但可以包含段落

这种设计保证了排版引擎能够正确处理不同内容类型的布局特性，避免产生不可预期的渲染结果。

解决方案

正确的实现方式是通过set规则定义段落样式，而不是直接包裹内容：

#let p-compact(it, spacing: 1em, leading: 1em) = {
  set par(spacing: spacing, leading: leading)
  it
}

#p-compact()[
  段落文本
  
  另一个段落

  - 正常显示的列表项
  - 第二个列表项
]

这种模式具有以下优势：

1. 保持内容层级的正确性
2. 样式定义与内容分离
3. 可复用的段落样式组件

最佳实践建议

1. 对于简单文档，优先使用set par全局设置段落样式
2. 需要特殊段落样式时，创建样式函数而非直接使用par
3. 列表内容应当放置在段落外部，作为同级或上级元素
4. 复杂布局考虑使用block或box进行显式分组

理解Typst的内容模型层级关系，可以帮助开发者避免常见的排版问题，构建出结构清晰、样式规范的文档。