« Comment écrire des tableaux en Markdown déjà ? Comment spécifier le langage des blocs de code ? Comment ajouter des notes de bas de page ? Le texte barré c'est un tilde ou deux ? » — perdre du temps à chercher la syntaxe à chaque écriture de doc.
Mettez cette page en favoris — nous avons organisé toute la syntaxe Markdown par catégorie, chacune avec des exemples et des descriptions du rendu. Plus besoin d'alterner entre moteurs de recherche et documentation.
01 Formatage en ligne
Le formatage en ligne applique des balises de style au texte dans les paragraphes. Ils ne créent pas de nouveaux éléments de bloc mais stylisent directement le texte là où ils apparaissent.
Référence rapide du formatage en ligne
| Effet | Syntaxe Markdown | Rendu |
|---|---|---|
| Gras | **texte en gras** | texte en gras |
| Italique | *texte en italique* | texte en italique |
| Gras Italique | ***gras italique*** | gras italique |
| Texte barré | ~~supprimé~~ | supprimé |
| Code en ligne | `code` | code en monospace |
| Lien | [texte](URL) | hyperlien cliquable |
| Image |  | image intégrée |
| Surbrillance | ==surligné== | surbrillance fond jaune |
02 Éléments de bloc
Les éléments de bloc occupent une ou plusieurs lignes et forment la structure principale d'un document. Ils sont le squelette d'un document Markdown.
Référence rapide des éléments de bloc
| Élément | Syntaxe Markdown | Description |
|---|---|---|
| Titres | # à ###### | 6 niveaux de titres, plus de # = plus petit |
| Paragraphe | Texte séparé par des lignes vides | Une ligne vide commence un nouveau paragraphe |
| Citation | > texte cité | Emboîtable : >> pour le deuxième niveau |
| Liste non ordonnée | - Élément un | Aussi * ou +, - est le plus courant |
| Liste ordonnée | 1. Premier élément | Les numéros peuvent être non séquentiels |
| Liste de tâches | - [ ] à faire / - [x] fait | Extension GFM, rendu en case à cocher |
| Ligne horizontale | --- ou *** ou ___ | Au moins 3 caractères, sur sa propre ligne |
03 Code
Le code en ligne utilise des accents graves simples `code`, idéal pour les noms de variables, de fonctions et les commandes courtes. Les blocs de code utilisent des barrières de trois accents graves avec un identifiant de langage pour la coloration syntaxique.
Identifiants de langage courants : javascript / js, typescript / ts, python / py, html, css, json, bash / shell, sql, java, c / cpp, go, rust, yaml, markdown / md.
Si vous ne connaissez pas l'identifiant de langage, omettez-le (mode texte brut). L'indentation de 4 espaces crée aussi des blocs de code (syntaxe héritée), mais les blocs de code clôturés sont plus clairs et recommandés.
Ajouter {1,3-5} après l'identifiant de langage active la surbrillance de lignes dans certains moteurs de rendu (pas du Markdown standard, mais supporté par VitePress, Docusaurus, etc.).
04 Tableaux
Les tableaux Markdown utilisent des barres verticales | pour séparer les colonnes, avec --- à la deuxième ligne séparant les en-têtes du contenu. L'alignement est contrôlé par la position des deux-points.
Syntaxe d'alignement des tableaux
| Syntaxe | Alignement | Effet |
|---|---|---|
| :--- | Aligné à gauche | Alignement par défaut |
| :---: | Centré | Bon pour les titres, données courtes |
| ---: | Aligné à droite | Bon pour les colonnes de chiffres |
05 Syntaxe étendue
La syntaxe suivante appartient au Markdown étendu (principalement de GitHub Flavored Markdown ou d'autres dialectes), pas universellement supportée mais largement disponible dans les outils Markdown modernes.
- Notes de bas de page : utilisez [^1] dans le texte, puis définissez [^1]: contenu en bas. Rendu en références de notes cliquables.
- Listes de définition : terme sur une ligne, : définition sur la suivante. Supporté par certains moteurs de rendu.
- Abréviations : *[HTML]: Hyper Text Markup Language. Survoler HTML affiche la forme complète.
- Table des matières : certains outils supportent le marqueur [TOC] pour la génération automatique.
- Formules mathématiques : $E = mc^2$ (en ligne) et $$...$$ (bloc), rendu avec KaTeX ou MathJax.
- Emoji : :smile: :rocket: :warning:, supportés par GitHub et de nombreux éditeurs Markdown comme codes courts.
- Exposant/indice : H~2~O (indice), X^2^ (exposant), supporté par certains éditeurs.
FAQ
Comment insérer un saut de ligne (et non un nouveau paragraphe) en Markdown ?
Ajoutez deux espaces ou plus en fin de ligne, puis appuyez sur Entrée. Ou utilisez la balise HTML <br>. Un simple Entrée ne produit qu'un espace, pas un saut de ligne — c'est la fonctionnalité Markdown la plus déroutante pour les débutants.
Les tableaux Markdown peuvent-ils fusionner des cellules ?
Le Markdown natif ne supporte pas la fusion de cellules. Si vous avez besoin de fusionner des cellules, intégrez des balises HTML <table> directement dans le Markdown avec les attributs rowspan et colspan.
Quelle est la différence entre CommonMark et GFM ?
CommonMark est la spécification de standardisation du Markdown, définissant le comportement précis de la syntaxe de base. GFM (GitHub Flavored Markdown) est un surensemble de CommonMark ajoutant tableaux, listes de tâches, texte barré, liens automatiques, etc. L'éditeur Suried est compatible GFM.
Comment échapper les caractères spéciaux en Markdown ?
Ajoutez un antislash \ avant les caractères spéciaux : \* affiche un astérisque, \# affiche un dièse, \[ affiche un crochet, etc. Caractères à échapper : \ ` * _ { } [ ] ( ) # + - . ! |
Cet aide-mémoire s'applique-t-il à tous les éditeurs Markdown ?
La syntaxe de base (titres, gras, listes, liens, code) fonctionne dans tous les éditeurs Markdown. Le support de la syntaxe étendue (notes de bas de page, surbrillance, formules mathématiques) varie selon l'éditeur. L'éditeur Markdown Suried prend en charge toute la syntaxe listée dans cette référence.
Try the Tool Now
Mettez cette page en favoris — nous avons organisé toute la syntaxe Markdown par catégorie, chacune avec des exemples et des descriptions du rendu. Plus besoin d'alterner entre moteurs de recherche et documentation.