Table of Contents — blnk docs

Last updated May 2026

Advanced Block

All plans

An inline card that auto-generates a clickable outline of your document from its headings, updating live as you type. Add with /toc or /table of contents.

How it works

The block scans every heading1, heading2, and heading3 block currently in the document and lists their text in document order, indented by level. It re-scans automatically whenever blocks change — there is nothing to manually refresh. Headings without text are skipped.

Clicking an entry scrolls smoothly to that heading. While scrolling, the entry closest to the top of the viewport is highlighted as the active item, tracked via an IntersectionObserveron each heading's block element.

Empty state

If the document has no headings yet, the block shows “No headings yet” instead of an empty list.

Configuration

The block has no settings panel and no editable content — it is entirely derived from the document's headings.

Publishing

⚠

This block currently does not render on published pages — the public page renderer returns nothing for it, so visitors will not see it even though it works normally in the editor. If you need heading navigation on a published page, there is a separate, unrelated floating table-of-contents feature that operates on the editor canvas itself rather than this block.

(none)

This block stores no metadata — its content is always derived live from the document’s current headings.

← PreviousToggle Next →Tab Bar