How to add the contents
- Paste your Markdown, or open the file.
- Click in the editor where the contents should go, usually under the title.
- Press Insert contents. A "Contents" heading and a linked list appear.
- Press Download PDF. Each entry is a link that jumps to its heading in the PDF.
What goes into the list
- Headings at level 2 and level 3. Level 4 and below are left out so the list stays short.
- The first level 1 heading is treated as the title and is skipped when it is the only one.
- Headings inside code blocks are ignored, so a shell comment that starts with # is not listed.
- An existing "Contents" heading is not listed in itself.
- Two headings with the same name get separate links.
Keeping the list current
The list is plain Markdown after you insert it. It does not update on its own. If you add or rename a heading, delete the old list and press the button again.
You can also edit the list by hand. Remove entries you do not want, or change the labels. The links only need to keep the same name as the heading, in lowercase with hyphens.
Page numbers
A contents list is more useful with page numbers on the pages. Turn on Page numbers before you download. They print in the footer as "1 / 3" in Chrome and Edge. The list itself does not show the page of each entry, because a browser cannot know that in advance.