Qu’est-ce que Markdown et comment l’utilisez-vous?

, et bien d’autres. Les ordinateurs n’ont aucun problème à les lire car ils suivent simplement la syntaxe (les règles du HTML) et appliquent la mise en forme qui correspond aux balises.

Les balises, cependant, rendent assez difficile pour les humains la lecture du HTML et la compréhension de l’apparence du texte après que l’ordinateur le rende. Ce n’est pas très «convivial» pour les personnes qui n’ont pas beaucoup d’expérience de lecture.

Markdown, en revanche, signifie « être aussi facile à lire et à écrire que possible. » John Gruber et Aaron Schwartz expliquent pourquoi ils ont créé Markdown en 2004 et fournissent un guide de la syntaxe sur Site Web de Gruber.

En bref, Markdown facilite la mise en forme du texte des pages Web car ses balises sont plus simples que le HTML et se convertissent automatiquement en HTML. Cela signifie que vous n’avez pas besoin de connaître le HTML pour écrire quelque chose pour une page Web, car Markdown traduit vos balises en HTML pour vous.

Il ne couvre pas toutes les balises HTML possibles, mais plutôt les options de mise en forme les plus courantes.

Comment utilisez-vous Markdown?

Pour utiliser Markdown, il vous suffit d’appliquer des balises simples à votre texte. Par exemple, pour mettre en forme le texte en italique, vous mettez des traits de soulignement autour de celui-ci comme ceci: _c’est un texte en italique_.

Voici quelques autres exemples de mise en forme Markdown à partir du guide de syntaxe:

En-têtes

# Ceci est un H1

## Ceci est un H2

###### Ceci est un H6

Points de balle

* Rouge
* Vert
* Bleu

Listes numérotées

1. Oiseau
2. McHale
3. Paroisse

Emphase (italique)

*texte*
_texte_

Markdown convertit à la fois * text * et _text_ en HTML ou tag, qui, en théorie, peut être interprété de plusieurs manières. Par exemple, vous pouvez créer une application qui interprète le balise sous forme de texte rouge clignotant. Dans la pratique, cependant, presque toutes les applications (y compris tous les navigateurs Web) l’interprètent comme du texte en italique.

Fort (gras)

**texte**
__texte__

Markdown convertit à la fois ** text ** et __text__ en HTML balise, qui apparaît généralement sous forme de texte en gras. En d’autres termes, pour une accentuation supplémentaire, utilisez des caractères doubles * ou _.

Il existe également des variantes de Markdown, telles que CommonMark et Markdown aromatisé GitHub (GFM) – mais ils sont tous basés sur la spécification Markdown d’origine. Les variantes étendent généralement simplement la norme en ajoutant des balises de mise en forme que le Markdown d’origine ne couvre pas.

Après avoir mis en forme votre texte, une application doit le convertir en HTML, ce qui est généralement fait automatiquement. Par exemple, les fichiers README dans GitHub utilisent Markdown, et tant qu’ils ont une extension de fichier .MD, GitHub les convertit automatiquement en balises HTML correctes lors de leur publication.

Donc, dans la plupart des cas, vous n’aurez pas à faire cela vous-même, mais si vous le faites, il y a un Outil Markdown disponible.

Où pouvez-vous utiliser Markdown?

Comme nous l’avons mentionné ci-dessus, vous pouvez utiliser Markdown sur GitHub, mais aussi sur Reddit, StackOverflow et d’autres sites Web. Si vous avez déjà mis en forme du texte dans des messages WhatsApp ou des conversations Slack, vous l’avez déjà utilisé car ces applications utilisent un (très petit) sous-ensemble de balises Markdown pour formater le texte.

Si vous voulez apprendre Markdown, consultez l’original Guide de syntaxe Markdown ou un tiers site de tutoriel. C’est facile à apprendre et cela facilitera la lecture de vos fichiers README et des commentaires Reddit ou StackOverflow pour les autres.