Some resources for generating a TOC for your GitHub readme
- DocToc - CLI tool to generate table of contents for Markdown files.
- DocToc web - Web-service for the above.
- gh-md-toc - Easy TOC creation for GitHub readme.
- Markdown All in One - VS Code extension with updatable TOC.