分页符

分页符会强制中断页面流，使分页符之后的内容出现在下一页。分页符不会影响 plain 与 docs 文档，打印时除外。

注意：在 slides 文档的语境下，页面 一词与幻灯片 可互换。

手动分页

你可以通过两种方式触发分页符：

• 放置一个只包含连续 3 个（或更多）< 字符的行：

  Page 1
  
  <<<
  
  Page 2

• 使用 .pagebreak ^{文档 ↗} 函数：

  Page 1
  
  .pagebreak
  
  Page 2

<<< 模式不会中断当前的块，因此如果未满足关闭一个块的标准（例如段落需要一个空行），它可能会显示为普通文本。以下示例不会触发分页符。

Page 1
<<<
Page 2

自动分页

一个标题块（# This!）可以自动触发分页。

默认情况下，只有 1 级标题（一个 # 符号）会触发自动分页，但你可以通过 .autopagebreak 函数进行自定义。请在源代码 setUp 区域（与元数据、页面格式等一起）调用此函数。

该函数接受一个 maxdepth 整数参数，用于指示一个标题为了触发分页所能具有的最大层级。标题层级范围从 1 到 6。

.autopagebreak maxdepth:{3}

## A    <!-- Break -->

### B   <!-- Break -->

#### C  <!-- Break -->

##### D <!-- No break -->

禁用自动分页

.noautopagebreak 等价于 .autopagebreak {0}，用于禁用自动分页。