Markdown: авто-оглавление

Установка

brew install node
npm install -g markdown-toc

В начале README (или любого .md) вставить маркеры (вместо них появится оглавление)

<!-- toc -->
<!-- tocstop -->

markdown-toc -i README.md