Qu'est-ce que le Markdown ? Guide complet de la syntaxe et du formatage

Qu'est-ce que le Markdown ?

Le Markdown est un langage de balisage léger créé par John Gruber en 2004. Son objectif est de permettre aux gens d'écrire du contenu dans un format texte brut facile à lire et à écrire, tout en étant convertible en HTML valide. Les fichiers Markdown utilisent l'extension .md et sont supportés par pratiquement toutes les plateformes de développement, systèmes de gestion de contenu et applications de prise de notes.

La philosophie clé du Markdown est qu'un document doit être lisible même sous sa forme brute, sans rendu spécial. Cela le rend idéal pour le contrôle de version, l'édition collaborative et la documentation technique.

Titres

Le Markdown supporte six niveaux de titres, créés en préfixant le texte d'un à six symboles dièse :

• # Titre 1 — Le plus grand titre, généralement utilisé pour les titres de page
• ## Titre 2 — Titres de sections principales
• ### Titre 3 — Titres de sous-sections
• #### Titre 4 à ###### Titre 6 — Titres progressivement plus petits

Formatage du texte

Le Markdown offre une syntaxe simple pour le formatage de base :

• Texte en gras : Entourez le texte de doubles astérisques (**gras**) ou de doubles tirets bas (__gras__)
• Texte en italique : Entourez le texte de simples astérisques (*italique*) ou de simples tirets bas (_italique_)
• Texte barré : Entourez le texte de doubles tildes (~~barré~~)
• Code en ligne : Entourez le texte d'accent graves (`code`)

Listes

Le Markdown supporte les listes ordonnées et non ordonnées :

• Listes non ordonnées : Utilisez des astérisques (*), des signes plus (+) ou des tirets (-)
• Listes ordonnées : Utilisez des nombres suivis de points (1., 2., 3.)
• Listes imbriquées : Indentez les éléments de deux ou quatre espaces pour créer des sous-listes

Liens et images

Ajouter des liens et des images est simple :

• Liens : [Texte du lien](URL) crée un hyperlien
• Images : ![Texte alternatif](url-image) insère une image
• Liens par référence : Définissez les liens en bas du document pour une meilleure lisibilité

Blocs de code

Pour du code multi-lignes, utilisez triples accent graves (```) ou triples tildes (~~~). Vous pouvez spécifier le langage de programmation après le marqueur d'ouverture pour la coloration syntaxique.

Tableaux

Les tableaux Markdown utilisent des pipes et des tirets pour créer des lignes et des en-têtes. Les tableaux de base font partie du Markdown standard, tandis que les fonctionnalités étendues comme l'alignement des cellules utilisent la spécification GitHub Flavored Markdown (GFM).

Citations et lignes horizontales

Les citations sont créées avec le symbole > et sont utiles pour citer des sources. Les lignes horizontales peuvent être créées avec trois tirets ou plus (---), astérisques (***) ou tirets bas (___).

La simplicité et l'universalité du Markdown en font le format de choix pour les développeurs, rédacteurs et tous ceux qui doivent créer du contenu textuel bien structuré rapidement.