Come posso creare un sommario per un documento markdown con Python / AWK / SED?

Ho il seguente documento markdown:

Heading-a
==========

---text---

Heading-b
------------

--- text ---

Heading-c
----------

--- text---

Heading-d
=======

--- text----

Heading-e
---

...

Vorrei ricavarne un sommario cliccabile, simile al modo in cui LaTex fa, ma non riesco a trovare uno strumento che lo faccia, il che mi suggerisce che dovremmo costruirne uno.

Lo strumento dovrebbe raccogliere le intestazioni "H1" e "H2" in modo tale da assegnare il numero 1 al Heading-ae il numero 1.1. a Heading-b, 1.2. a Heading-c, 2. a Heading-d, 2.1. a Heading-ee così via, in modo tale che si dovrebbe ottenere il seguente indice:

  1. Heading-a
  1.1. Heading-b
  1.2. Heading-c
  2. Heading-d
  2.1. Heading-e

Come posso farlo con Python / AWK / SED?

L' implementazione Markdown in Python ha il supporto per le estensioni, una delle quali include la generazione di Sommario. Inoltre Pandoc (che è un markup Haskell-> PDF ha il supporto per il markdown (oltre a un sacco di altri formati) e può produrre piuttosto HTML, LaTeX, PDF, ecc.

Se hai già titoli, puoi provare github-markdown-toc è in grado di elaborare file stdin, locali e remoti, ad esempio:

cat ~/projects/Dockerfile.vim/README.md | ./gh-md-toc -

o creando un locale README.md:

./gh-md-toc ~/projects/Dockerfile.vim/README.md

Consulta questo articolo per un confronto tra linguaggi di markup leggeri con alcune informazioni sugli indici che potrebbero indirizzarti verso una soluzione.