Automatic TOC in github-flavoured-markdown

Question

Is it possible to generate an automatic Table of Contents using Github Flavoured Markdown?

Answer 1

Currently it's not possible using markdown syntax (see the ongoing discussion at GitHub), however you can use some external tools such as:

• Online Table Of Content Generator (raychenon/play-table-of-contents)
• arthurhammer/github-toc - browser extension that adds a table of contents to GitHub repos

---

Alternatively use AsciiDoc instead (e.g. README.adoc), e.g.

:toc: macro
:toc-title:
:toclevels: 99
# Title

## A

### A2

## B

### B2

as suggested in this comment. Check the demo here.