Comme vous l'avez probablement remarqué dans nos articles précédents sur MakeUseOf, nous adorons Markdown. Ce format simple et intuitif permet de transformer facilement un fichier texte brut en documents attrayants, qu'il s'agisse de PDF ou de pages web sophistiquées.
Mais Markdown n'est pas le seul en lice. D'autres langages de balisage légers, comme AsciiDoc, offrent des fonctionnalités étendues. Si vous appréciez Markdown mais souhaitez plus de puissance, AsciiDoc mérite votre attention. Voici pourquoi.
Un langage de balisage est un ensemble de codes appliqués à du texte brut pour ajouter des propriétés telles que :
HTML, que vous utilisez quotidiennement sur les sites web et applications, en est un exemple courant. Il repose sur des balises. Par exemple :
<body>
<h1>Présentation du HTML</h1>
<p>
Voici un paragraphe en HTML... nous savons que c'est un <strong>paragraphe</strong>
car les balises <p> environnantes le définissent comme tel.
</p>
</body>La balise <p> définit un paragraphe, <body> gère la mise en page, et <strong> ou <h1> ajoutent style et structure.
Cependant, des langages comme HTML ou XML (ex. : DocBook pour les publications techniques) sont verbeux et fastidieux à saisir manuellement.
Dans cet extrait DocBook, les balises (en violet) dominent le texte. Toute erreur empêche la conversion en PDF.
Autrefois, pour publier en HTML ou convertir DocBook en PDF, il fallait maîtriser ces langages ou acheter des outils coûteux. Les langages légers comme Markdown, AsciiDoc, Org-Mode ou MediaWiki simplifient la syntaxe tout en conservant les fonctionnalités essentielles.
Leur balisage est naturel. Exemple en AsciiDoc :
Présentation d'AsciiDoc
---------------------
Où sont les balises *paragraphe* ? AsciiDoc les détecte automatiquement !Plus lisible : soulignement pour les titres, astérisques pour le gras, paragraphes auto-détectés.
Les langages lourds s'affichent directement (navigateurs pour HTML). Les légers nécessitent un processeur : script Perl pour Markdown, Python pour AsciiDoc. Pandoc convertit en PDF, DOCX, etc.
Travaillez en texte brut portable, obtenez une sortie professionnelle.
AsciiDoc simplifie DocBook pour l'écriture technique longue. Voici ses atouts et limites face à Markdown.
Markdown cible le web simple (listes, etc.). AsciiDoc ajoute avertissements, tableaux complexes.
Utilisez-les au besoin.
Markdown s'est fragmenté (GitHub Flavored, MultiMarkdown). AsciiDoc reste cohérent.
Markdown excelle pour blogs. AsciiDoc gère livres via include::fichier.adoc.
Pour notes ou blogs simples, Markdown couvre l'essentiel.
Éditeurs WYSIWYG, services (GitHub), générateurs de sites favorisent Markdown.
Mardown domine, mais AsciiDoc offre plus pour projets complexes. Qu'en pensez-vous ? Restez-vous sur Markdown ou explorez-vous AsciiDoc ? Dites-le en commentaires !
[]