TOC Depth

Quarto Extension

This document demonstrates the TOC Depth extension functionality.

Author

Installation

quarto add mcanouil/quarto-toc-depth

This will install the extension under the _extensions subdirectory. If you’re using version control, you will want to check in this directory.

Add the filter to your document’s YAML header:

filters:
  - toc-depth

Then control TOC depth for specific sections using the toc-depth attribute on headers: {toc-depth=N}.

Note

The TOC depth is relative to the section where it is defined.

This section uses Quarto’s default table of contents behaviour.

This subsection will appear in the TOC.

This nested subsection will also appear in the TOC.

# Section Hidden from TOC {toc-depth=0}

This entire section and all its subsections will be hidden from the table of contents.

This will not appear in the TOC.

This will also not appear in the TOC.

# Section with Limited Depth {toc-depth=2}

This section will appear in the TOC, along with its direct children.

This subsection will appear in the TOC (depth = 2).

This nested subsection will NOT appear in the TOC (depth = 3).

# Another Section with Single Level {toc-depth=1}

This section will appear in the TOC, but its direct children will be hidden.

This subsection will NOT appear in the TOC (depth = 2).

This will NOT appear in the TOC (depth = 3).

This will also not appear in the TOC (depth = 4).

This section returns to the default TOC behaviour and will display all subsections according to your document settings.