La syntaxe Markdown avec des exemples à copier
Trouvez la syntaxe, copiez un exemple et comparez le code au résultat. Les sections distinguent la base portable de CommonMark des extensions courantes de GFM.
Markdown en quelques mots
Markdown utilise des signes simples pour exprimer la structure : # pour les titres, des astérisques pour l’emphase, des tirets pour les listes et crochets plus parenthèses pour les liens. Les tableaux, tâches et texte barré sont des extensions fréquentes de GFM.
Comment utiliser Aide-mémoire Markdown
Cherchez une règle de syntaxe ou consultez un exemple, puis testez le code copié dans votre destination finale.
- 1Trouver la syntaxeChoisissez la section qui correspond à votre besoin.
- 2Copier l’exempleCopiez le code Markdown et adaptez son contenu.
- 3Tester le renduVérifiez l’exemple dans la destination où il sera publié.
Créer des titres avec #
Utilisez d’un à six signes # suivis d’une espace.
# Titre principal
## Section
### Sous-sectionRésultat : Trois niveaux de titre
- Ajoutez une espace après le marqueur lorsque la syntaxe l’exige.
- Vérifiez le rendu dans la destination finale.
Séparer les paragraphes
Laissez une ligne vide entre deux paragraphes.
Premier paragraphe.
Deuxième paragraphe.Résultat : Deux paragraphes
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Gras, italique et barré
Les astérisques ou traits de soulignement marquent l’emphase. Le barré est une extension GFM.
**gras**
*italique*
~~barré~~Résultat : Trois styles d’emphase
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer des listes à puces
Utilisez -, * ou + suivis d’une espace. Indentez les sous-éléments.
- Premier
- Deuxième
- Sous-élémentRésultat : Liste avec sous-élément
- Ajoutez une espace après le marqueur lorsque la syntaxe l’exige.
- Vérifiez le rendu dans la destination finale.
Créer une liste numérotée
Ajoutez un nombre, un point et une espace.
1. Première étape
2. Deuxième étapeRésultat : Deux étapes numérotées
- Ajoutez une espace après le marqueur lorsque la syntaxe l’exige.
- Vérifiez le rendu dans la destination finale.
Ajouter un lien
Placez le libellé entre crochets et l’URL entre parenthèses.
[ilovemd](https://ilovemd.net)Résultat : Lien vers ilovemd
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Ajouter une image et son texte alternatif
Ajoutez ! devant la syntaxe de lien. Décrivez l’image avec précision.
Résultat : Image avec texte alternatif
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer un bloc de citation
Commencez chaque paragraphe cité par >.
> Une citation utile.
>
> Un second paragraphe.Résultat : Citation en deux paragraphes
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Afficher du code en ligne
Entourez un court fragment avec des accents graves.
Utilisez `npm run build`.Résultat : Commande dans une phrase
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer un bloc de code
Utilisez trois accents graves et ajoutez éventuellement le langage.
```js
const ok = true;
```Résultat : Bloc JavaScript
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Ajouter une ligne horizontale
Écrivez trois tirets seuls sur une ligne.
---Résultat : Séparateur horizontal
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Forcer un retour à la ligne
Terminez la ligne par deux espaces ou utilisez une balise <br> si la destination l’accepte.
Première ligne.
Deuxième ligne.Résultat : Deux lignes dans le même paragraphe
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Écrire un tableau Markdown
Ajoutez un en-tête, une ligne de séparation et des lignes de données.
| Outil | Usage |
| --- | --- |
| Éditeur | Écrire |Résultat : Tableau de deux colonnes
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer une liste de tâches
Ajoutez [ ] ou [x] après le marqueur de liste.
- [x] Écrire
- [ ] RelireRésultat : Une tâche terminée et une tâche à faire
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Afficher un caractère Markdown
Placez une barre oblique inverse devant le caractère réservé.
\*pas en italique\*Résultat : Astérisques visibles
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer un lien automatique
Entourez l’URL de chevrons ; certaines plateformes reconnaissent aussi les URL nues.
<https://ilovemd.net>Résultat : URL cliquable
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Créer une section repliable
Le HTML brut dépend du moteur et peut être filtré.
<details>
<summary>Détails</summary>
Contenu.
</details>Résultat : Bloc repliable
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
Ajouter un commentaire masqué dans le rendu
Lorsque le HTML brut est accepté, les commentaires HTML sont masqués dans le rendu, mais restent dans la source.
<!-- note interne -->Résultat : Commentaire caché dans le rendu
- Respectez exactement la syntaxe montrée dans l’exemple.
- Vérifiez le rendu dans la destination finale.
CommonMark et GitHub Flavored Markdown
La syntaxe de base est largement reconnue, mais les extensions ne sont pas universelles. Contrôlez le CMS, l’éditeur ou le dépôt où le contenu sera publié.
Titres, paragraphes, emphase, citations, listes, code, liens, images et séparateurs forment le socle portable.
Tableaux, tâches, texte barré et liens automatiques étendus dépendent du moteur.
Spécifications : CommonMark · GFM
Questions sur la syntaxe Markdown
Que conserve cet outil ?
Chaque module montre le code et le résultat attendu. Les tableaux, tâches et barré sont signalés comme extensions. Les notes de compatibilité évitent de promettre un dialecte unique. Vérifiez néanmoins le résultat dans l’application cible.
Pourquoi le résultat peut-il différer de la source ?
Les formats n’offrent pas les mêmes fonctions. La fiche ne couvre pas toutes les extensions de chaque plateforme. Tableaux et tâches ne font pas partie du cœur CommonMark.
Comment valider le fichier obtenu ?
Testez le HTML brut et les règles propres à la destination. Conservez la source jusqu’à la fin de la comparaison.
