Comment ajouter une table des matières dans un document Markdown

Markdown est un langage très sympa pour éditer rapidement et facilement des documents. Ses deux points forts sont que même non interprété, le source du document reste lisible par un humain et que la syntaxe de Markdown est très simple.

Un point faible de Markdown est qu'il n'y a pas de façon native de possibilité pour intégrer automatiquement une table des matières.

En voici une, basée sur une solution en JavaScript que j'ai trouvé ici

Insérez simplement les lignes suivantes dans le document :

<!-- Importation du script : a insérer au début du document -->
<script type="text/javascript" src="generated_toc.js"></script>
 
<!-- Génération de la table des matières : à insérer à l'emplacement voulu -->
<div id="generated-toc"></div>