Banners and Table of Contents

A more prominent way to present author, title and date in the title block
Author

Example Author

Published

January 1, 2000

Table from “Graphis diagrams: The Graphic Visualization of Abstract Data”

Table of Contents

This page demonstrates two types of tables of contents (TOC): a floating TOC on the right that follows your scroll position, and a fixed TOC at the top of the page.

You can control TOC behavior with several options (see the full reference):

toc: true
toc-depth: 2
toc-location: right-body  # alternatives: "right", "left", "body"
  • toc: Enables the table of contents.
  • toc-depth: Controls how many heading levels are included.
  • toc-location: Controls placement:
    • right or left creates a floating sidebar TOC.
    • body places the TOC directly in the document.
    • right-body combines both approaches.

Note: Floating TOCs are not displayed on mobile devices. If it’s important that readers always have an overview of the page structure, consider including a body TOC as well.