
For example, with shift-heading-level-by: -1, level 2 headings become level 1 headings, and level 3 headings become level 2 headings. Shift heading levels by a positive or negative integer.

If your document starts with a level-2 heading which you want to be numbered “1.5”, specify number-offset.

So, for example, if you want the first top-level heading in your document to be numbered “6”, specify number-offset: 5. Offset for section headings in output (offsets are 0 by default) The first number is added to the section number for top-level headings, the second for second-level headings, and so on. You customize numbering depth using the number-depth option.įor example, to only number sections immediately below the chapter level, use this: unnumbered will never be numbered, even if number-sections is specified.īy default, all headings in your document create a numbered section. The title used for the table of contents. Specify the number of section levels to include in the table of contents. If you would prefer it to be at the end of the document, use the option pdf-engine-opt: -no-toc-relocation. Note that if you are producing a PDF via ms, the table of contents will appear at the beginning of the document, before the title. This option has no effect if standalone is false. Include an automatically generated table of contents (or, in the case of latex, context, docx, odt, opendocument, rst, or ms, an instruction to create one) in the output document.
