The below "Table of Contents" has been generated using tocgen.

• TOC Generator for Markdown documents
  • Usage
    • Step 1
    • Step 2
    • Step 3
  • Contribute

Put the placeholder [TOC] followed by 2 spaces and a new-line (viz. press Enter key) wherever you want the Table of Contents to appear in your markdown file.

Then simply:

tocgen <path to the markdown file>
# If path is not provided, tocgen searches its working directory for *.md files

It does an in-place edit of the file provided. The injected "Table of Contents" contains a trailing blank level 5 heading. DO NOT delete this blank heading as tocgen uses it to delimit the "Table of Contents" during subsequent updates (see below).

Edit your document as necessary - adding, editing and removing headings. When you finish editing, in order to update the "Table of Contents", simply repeat the command given above.

Report bugs or discuss ideas and new features. PRs welcome.