> For the complete documentation index, see [llms.txt](https://quarkdown.com/wiki/llms.txt).

# Page break

A page break is a forced interruption of the page flow that causes content following the break to appear on the next page. Page breaks do not affect `plain` and `docs` documents, except for printing.

> The word *page* is interchangeable with *slide* in the context of a `slides` document.

## Manual break

You can trigger a page break in two ways:

- Placing a line containing only a sequence of 3 (or more) `<` characters:

  ```markdown
  Page 1

  <<<

  Page 2
  ```

- 

- Using the **`.pagebreak`**  function:

  ```markdown
  Page 1

  .pagebreak

  Page 2
  ```

> The `<<<` pattern does not interrupt the current block, so it might appear as plain text if the criteria for closing a block (such as an empty line for paragraphs) are not satisfied. The following example does not trigger a page break.

> **Example 1**
> 
> ```markdown
> Page 1
> <<<
> Page 2
> ```
> 
> Page 1
> \<\<\<
> Page 2

## Automatic break

A heading block (`# This!`) can automatically trigger a page break.

By default, only level-1 headings (one `#` symbol) trigger automatic page breaks, but you can customize this via the **`.autopagebreak`** function. Call this function in the setup area of your source code (along with metadata, page format, etc.).

This function takes a `maxdepth` integer argument that indicates the maximum level a heading should be in order to trigger a page break. Heading levels range from 1 to 6.

> **Example 2**
> 
> ```html
> .autopagebreak maxdepth:{3}
> 
> ## A    <!-- Break -->
> 
> ### B   <!-- Break -->
> 
> #### C  <!-- Break -->
> 
> ##### D <!-- No break -->
> ```

### Disabling automatic breaks

**`.noautopagebreak`**, which is equivalent to `.autopagebreak {0}`, disables automatic breaks.