Table of Contents support #189

Activity

1. GregJohnStewart

   added

   bug

   on Oct 15, 2020
2. GregJohnStewart commented on Oct 15, 2020

   

   GregJohnStewart

   on Oct 15, 2020

   Author

   More actions

   Sorry, meant to make this a feature request, not a bug
3. robinst

   added

   enhancement

   help wanted

   and removed

   bug

   on Oct 16, 2020
4. robinst commented on Oct 16, 2020

   

   robinst

   on Oct 16, 2020

   Collaborator

   More actions

   Hey! Yeah sounds like a useful extension. Looks like there's a couple of existing syntaxes, from here: https://alexharv074.github.io/2018/08/28/auto-generating-markdown-tables-of-contents.html

   • {:toc}
   • [[_TOC_]]
   • [toc]

   And this one doesn't seem to need any syntax, so I assume if the extension is used it is inserted at the top of the document: https://commonmark.thephpleague.com/1.5/extensions/table-of-contents/

   Any thoughts about what we should do? Some more research into prior art would be good.
5. robinst commented on Oct 16, 2020

   

   robinst

   on Oct 16, 2020

   Collaborator

   More actions

   Also, it would probably need to be paired with the heading anchor extension (https://github.com/atlassian/commonmark-java#heading-anchor) to be able to link to headers.
6. colinodell commented on Jun 26, 2021

   

   colinodell

   on Jun 26, 2021

   More actions

   And this one doesn't seem to need any syntax, so I assume if the extension is used it is inserted at the top of the document

   We support three options:

   • Place the ToC at the very top of the document - no syntax needed (default)
   • Place the ToC just prior to the first heading in the document - no syntax needed
   • Place the ToC anywhere that a given placeholder string (like [TOC]) is found; this placeholder syntax is customizable

   👍React with 👍2Reacted by Robin Stocker and jngross95

   👀React with 👀2Reacted by Sooxin and jngross95
7. ia3andy commented on Jan 23, 2026

   

   ia3andy

   on Jan 23, 2026

   Contributor

   More actions

   You could also generate it in the browser like here (and get scroll sync in bonus):
   https://ia3andy.github.io/the-code-site/posts/discover-roq-the-quarkus-way-for-static-site-generation-in-java/

   Here is the script:
   https://github.com/ia3andy/the-code-site/blob/main/web/toc.js