# .chapter command (Output processor)

The .chapter command starts a new chapter.

**Synonyms:** .ch

Chapters start on new pages and the chapter counter is
incremented. The literal, Chapter, followed by
the optional text, is printed centered between the current margins.

The chapter, page number, and text are accumulated for the table
of contents.

## Syntax

```
.chapter {text}
```

## Parameter(s)

| text | Words or phrases following the chapter to be printed. |
| --- | --- |

## Example(s)

```
.chapter
Update processor
.chapter
Output processor
.chapter
```
Produces this output:

```
Chapter 1
Update processor
(page eject)
Chapter 2
Output processor
(page eject)
Chapter 3
```

## See also

- [.print ptoc command](https://d3codex.com/output-processor/dot-print-ptoc-command/)
- [.print toc](https://d3codex.com/output-processor/dot-print-toc/)
- [.set chapter command](https://d3codex.com/output-processor/dot-set-chapter-command/)
- [.set section](https://d3codex.com/output-processor/dot-set-section/)
- [Output processor commands](https://d3codex.com/output-processor/output-processor-commands/)
- [Output processor overview](https://d3codex.com/output-processor/output-processor-overview/)

---
Source: https://d3codex.com/output-processor/dot-chapter-command-output-processor/ - part of the D3Codex reference.