Syntaxe Markdown : Guide Complet de la Mise en Forme — Titres, Listes, Tableaux
Que vous soyez débutant en Markdown ou utilisateur régulier souhaitant approfondir vos connaissances, ce guide couvre l'ensemble de la syntaxe standard (CommonMark) et les extensions GitHub Flavored Markdown (GFM). Utilisez l'Aperçu Markdown de WikiPlus pour tester chaque exemple en temps réel pendant votre apprentissage — c'est la méthode la plus rapide pour mémoriser la syntaxe et voir immédiatement le rendu de chaque élément.
Titres, paragraphes et sauts de ligne
Les titres se créent avec le symbole # suivi d'un espace et du texte : # Titre H1, ## Titre H2, jusqu'à ###### Titre H6. Une ligne vide entre deux blocs de texte crée un nouveau paragraphe. Un saut de ligne simple dans l'éditeur n'est pas rendu comme un saut de ligne dans le HTML — pour forcer un saut de ligne (br), terminez la ligne par deux espaces ou utilisez un backslash \. Le texte gras s'écrit avec **texte** ou __texte__, l'italique avec *texte* ou _texte_, le gras-italique avec ***texte***, le texte barré avec ~~texte~~ (GFM). Le code inline s'insère avec des backticks : `code`. Ces éléments de base couvrent 80 % des besoins de formatage quotidien.
Listes, cases à cocher et imbrication
Les listes non ordonnées utilisent -, * ou + suivi d'un espace. Les listes ordonnées utilisent un nombre suivi d'un point : 1., 2., 3.. L'imbrication se fait par indentation de 2 ou 4 espaces. Les listes de tâches (GFM) utilisent - [ ] pour une case non cochée et - [x] pour une case cochée. Exemple : - [x] Tâche complétée, - [ ] Tâche en cours. Ces listes interactives sont particulièrement utiles dans les README GitHub, les wikis Notion et les spécifications de projets. Une liste peut contenir des sous-listes de différents types — ordonnée imbriquée dans non ordonnée et vice versa — en maintenant une indentation cohérente.
Tableaux, blocs de code et citations
Les tableaux GFM utilisent des pipes | et des tirets pour l'en-tête : | Colonne 1 | Colonne 2 | suivi de | --- | --- | puis des lignes de données. L'alignement des colonnes se contrôle avec :--- (gauche), ---: (droite), :---: (centre). Les blocs de code multi-lignes s'encadrent avec trois backticks (```) avec optionnellement le nom du langage pour la coloration syntaxique : ```javascript ... ```. Les citations (blockquote) commencent par > : > Texte cité. Les citations peuvent être imbriquées avec >> pour un deuxième niveau. Les règles horizontales se créent avec --- ou *** sur une ligne seule. Les liens s'écrivent [texte du lien](URL) et les images .
Extensions avancées : footnotes, math et diagrammes
Au-delà du CommonMark de base, de nombreuses plateformes supportent des extensions avancées. Les notes de bas de page (supported by Pandoc, GitHub Docs) : [^1] dans le texte et [^1]: Contenu de la note en bas du document. Les formules mathématiques LaTeX (Jupyter, Obsidian, certains CMS) : $formule$ pour l'inline et $$formule$$ pour les blocs. Les diagrammes Mermaid (GitHub, GitLab, Notion) permettent de créer des flowcharts et des diagrammes de séquence en Markdown. Les attributs HTML personnalisés (Markdown Extended) permettent d'ajouter des classes CSS et IDs aux éléments. Vérifiez quelles extensions votre plateforme cible supporte avant de les utiliser — elles ne sont pas universelles. L'Aperçu Markdown WikiPlus vous permet de tester rapidement le rendu de chaque syntaxe.
Questions fréquemment posées
- Quelle est la différence entre Markdown, CommonMark et GFM ?
- Markdown est la spécification originale de John Gruber (2004), assez ambiguë dans ses cas limites. CommonMark (2014) est une spécification standardisée et sans ambiguïté qui résout ces inconsistances. GitHub Flavored Markdown (GFM) est un superset de CommonMark ajoutant les tables, listes de tâches, mentions (@user), références d'issues (#123) et coloration syntaxique des blocs de code.
- Comment échapper des caractères spéciaux Markdown ?
- Utilisez le backslash \ avant un caractère pour l'afficher littéralement sans l'interpréter comme Markdown. Par exemple \* affiche un astérisque, \# affiche un dièse, \[ affiche un crochet ouvrant. Cette technique est utile pour écrire des exemples de syntaxe Markdown dans un document Markdown.
- Puis-je utiliser du HTML dans un document Markdown ?
- Oui, la plupart des parseurs Markdown permettent l'insertion de balises HTML directement dans le document. Cela est utile pour des fonctionnalités non supportées nativement par Markdown : centrer du texte avec <div style='text-align:center'>, ajouter des attributs, ou utiliser des tableaux HTML complexes. Certaines plateformes désactivent le HTML dans Markdown pour des raisons de sécurité (prévention XSS).