Manually maintaining a table of contents in markdown documents can be a lot of work. By combining [remark-toc](https://github.com/remarkjs/remark-toc) and [remark-slug](https://github.com/remarkjs/remark-toc) you can ensure generate your table of contents and ensure it's always up to date.