› ›

Optional sections

Books may include other sections such as a preamble, a preface, a glossary or appendices.

Preamble

= Book title                // level 0

.Optional preamble title
Preamble text...

Preface and Appendix

edit

[preface]
= Preface title             // level 0

=== Preface header          // level 2 

= Part one                  // level 0

and

[appendix]
= Appendix title            // level 0

=== Appendix header         // level 2

Any headers in the appendix or in the preface start out-of-sequence at level 2, not at level 1.

Glossary

edit

[glossary]
= Glossary title            // level 0

[glossary]
Term one::
    Defn for term one

Term two::
    Defn for term two

The two [glossary] elements above have different purposes:

The first marks this section of the document as a glossary, to be included in the table of contents
The second marks the definitions list as type glossary

Also see

edit

If you need to use some of these more advanced structural elements, have a look at the example of a multi-part book included in this repo in book-multi.txt.

« Multi-part books Paragraphs »