Les ordinateurs interprètent sans difficulté les langages de balisage comme le HTML, car ils suivent scrupuleusement la syntaxe définie et appliquent la mise en forme adéquate à chaque balise.
Cependant, la profusion de balises dans le HTML peut rendre sa lecture et la compréhension de l’apparence du texte difficile pour un humain. Ce n’est pas une approche très conviviale, notamment pour ceux qui n’ont pas l’habitude de décoder ce type de langage.
À l’inverse, le Markdown est conçu pour être « aussi facile à lire et à écrire que possible« . C’est ce que soulignent John Gruber et Aaron Schwartz en 2004, au moment de sa création, en proposant une documentation claire de la syntaxe sur le site web de Gruber.
En bref, le Markdown simplifie la mise en forme du texte pour le web grâce à des balises plus intuitives que le HTML, et il est automatiquement converti en HTML. Ainsi, il n’est pas nécessaire de maîtriser le HTML pour écrire du contenu web, car le Markdown se charge de la traduction.
Il ne prend pas en charge toutes les balises HTML possibles, mais il offre les options de formatage les plus courantes.
Comment employer le Markdown ?
Pour utiliser le Markdown, il suffit d’encadrer votre texte avec des balises simples. Par exemple, pour mettre un texte en italique, utilisez des tirets bas : _ceci est un texte en italique_.
Voici d’autres exemples de formatage Markdown, extraits du guide de syntaxe :
Titres
# Ceci est un titre de niveau 1
## Ceci est un titre de niveau 2
###### Ceci est un titre de niveau 6
Listes à puces
* Rouge
* Vert
* Bleu
Listes numérotées
1. Premier élément
2. Deuxième élément
3. Troisième élément
Mise en emphase (italique)
*texte*
_texte_
Le Markdown convertit aussi bien *texte* que _texte_ en balises HTML ou <em>. En principe, l’interprétation peut varier, mais dans la pratique, la quasi-totalité des applications, y compris les navigateurs web, affiche le texte en italique.
Texte en gras
**texte**
__texte__
De même, **texte** et __texte__ sont convertis en balise HTML <strong>, ce qui se traduit généralement par du texte en gras. Pour souligner un texte, utilisez donc un double * ou _.
Il existe des variantes du Markdown, comme CommonMark ou le Markdown aromatisé de GitHub (GFM). Ces dernières sont basées sur la spécification originale du Markdown. Elles ajoutent généralement des balises de mise en forme non couvertes par la version de base.
Une fois votre texte formaté, une application doit le convertir en HTML, une opération souvent automatique. Par exemple, les fichiers README de GitHub utilisent le Markdown, et à condition qu’ils aient l’extension .MD, GitHub les convertit automatiquement en balises HTML lors de leur affichage.
Dans la plupart des cas, vous n’aurez pas à faire cette conversion vous-même. Si vous souhaitez le faire manuellement, un outil Markdown est disponible.
Où utiliser le Markdown ?
Comme mentionné précédemment, le Markdown est utilisé sur GitHub, mais aussi sur des plateformes comme Reddit, StackOverflow, et d’autres sites web. Si vous avez déjà formaté du texte dans des messages WhatsApp ou Slack, vous avez déjà utilisé (un sous-ensemble très restreint) de balises Markdown pour mettre en forme votre texte.
Pour apprendre le Markdown, vous pouvez consulter le guide de syntaxe Markdown original ou un site tutoriel tiers. L’apprentissage est facile et vous facilitera la lecture des fichiers README et des commentaires sur Reddit ou StackOverflow.