Contents

Tier

directive

Surfaces

page

Fallback

literal

State

settled

A list of the page's own headings, worked out every time it is drawn.

::contents

A leaf directive and an ordinary block: it may stand in the flow, inside a column or inside the margin, and it means the same in all three.

Nothing about it is stored. The file records that it is there and nothing else — no heading text, no targets, no depth, no count. It is derived from the page's headings on every read — the files are the authority rule applied to one block.

It takes no attributes in this version: no depth limit, no numbering, no title, and no way to name another page. ::contents{depth="2"} states nothing this version reads.

This is not the maintained contents list a generated index.md carries; that one is written into the file between two HTML comment markers and is a different mechanism.