Preface Section Style

A preface is a special section that precedes the first chapter of a book or a book part.

Preface for a book

The preface section style can only be used when the doctype is book. A preface can contain subsections. When a book doesn’t contain parts, the preface must be defined as a level 1 section (==) and any preface subsections must start at level 2 (===).

= Book Title
:doctype: book

[preface]
== Our Preface

I awoke one morning and was confronted by the dark and stormy eyes of the chinchilla.
She had conquered the mountain of government reports that had eroded into several minor foothills and a creeping alluvial plain of loose papers.

=== Preface Subsection

Chinchillas rule the world.

== Chapter 1

...

Preface for a book part

To create a preface for a book part, the preface must be defined as a level 1 section (==) and any subsections must start at level 2 (===). The preface must be the first section in the part.

= Book Title
:doctype: book

= Part 1

[preface]
== Part 1 Preface

The preface for part 1.

=== Preface Subsection

More part 1 prefacing.

== Chapter 1

...

Hide the section title

If you don’t want the section title to be displayed, use the untitled option. This option only works with the Docbook backend.

The section still needs a title in the source, otherwise you can’t assign the special section style to it or link to the section with a cross reference.