标题

.heading {content} {depth} ^{文档 ↗} 函数用于创建标题，并对其行为进行精细控制。

与标准 Markdown 标题（#、## 等）不同，此函数允许显式控制编号、分页符、目录索引以及自定义标识符。

参数

参数	说明	可接受值	默认值
`content`	标题的行内内容。	行内内容	必填
`depth`	标题的重要层级（H1 为 1，H6 为 6）。	整数（1-6）	必填
`ref`	用于交叉引用的自定义标识符。若未设置，则会自动生成 ID。	String	未设置
`numbered`	标题是否被编号，并在文档层级中跟踪其位置。实际编号取决于当前生效的 `.numbering` 配置。	布尔值	`yes`
`indexed`	标题是否出现在目录与导航侧边栏中。	布尔值	`yes`
`breakpage`	标题是否触发自动分页。	布尔值	`yes`

这等价于标准 Markdown 中的 ## My heading。

.heading {My heading} depth:{2}

你可以创建不被编号系统跟踪的标题：

.heading {Appendix} depth:{1} numbered:{no}

与装饰性标题（#!）不同，这种方式让你可以独立控制标题是否出现在目录中。

默认情况下，标题会出现在 plain 与 paged 文档的目录与导航侧边栏中。你可以在仍然允许其被编号的同时排除某个标题：

.heading {Secret section} depth:{2} indexed:{no}

反之，你也可以将一个不带编号的标题纳入目录：

.heading {Acknowledgments} depth:{1} numbered:{no} indexed:{yes}

默认情况下，标题会触发自动分页（当.autopagebreak启用时）。你可以针对单个标题禁用此项：

.heading {Continued} depth:{1} breakpage:{no}

你可以为交叉引用分配一个自定义标识符：

.heading {Introduction} depth:{2} ref:{intro}

.heading 接受元素样式属性 中描述的全部选项，用于自定义颜色、间距、边框和文本外观。

.heading {Introduction} depth:{2} foreground:{teal} fontvariant:{smallcaps} indexed:{no}

另请参阅装饰性标题，了解被排除在编号与目录之外的标题。