Même si quand on n'aime pas le Markdown, parfois on n'a pas le choix

Même si quand on n'aime pas le Markdown, parfois on n'a pas le choix

2025, Jun 04    
🌐 Languages:

TL;DR;

downdoc -o out.md README.adoc

Les opinions exprimées sont les miennes. Il est possible que je les exagère pour des raisons narratives évidentes.

Vous détestez le Markdown. Et vous avez raison ! Et pourtant il semble se répandre comme une pandémie.

Le every thing as code étant évidemment votre mojo, la documentation ne pouvais pas y échapper. Et comme toute personnes sensée vous avez fait votre choix. Et il va sans dire que vous avez choisi le format ASCIIDOC.

J’imagine que vous ne seriez pas là si ce n’était pas le cas.

Et alors que tout va pour le mieux dans le meilleur des mondes arrive ce jour où les planètes se désalignent. Le jour où l’on vous dit que vous n’avez tout simplement pas le choix et devez produire du Markdown. 😢

Saaad keanu pleurant sur les _markdown flavors_

Vous n’êtes pas condamnés.

Il semble que Dan Allen, père d’Asciidoctor, soit d’accord avec vous à 100 %. Il vous envoie d’ailleurs ses meilleurs vœux.

Étrange, n’est-ce pas ?

Quoi qu’il en soit, il a également engendré Downdoc…​ Ce nom est absolument merveilleux, et voici son slogan :

Rapidly down-converts AsciiDoc to Markdown.

Vous pouvez soit utiliser npx :

npx downdoc -o out.md README.adoc

Ou l’installer en utilisant mise :

mise use -g npm:downdoc@latest
downdoc -v

All hail to ASCIIDOC

Toutes les images sont libres de droits.[1]