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.

Tester dans l’éditeur

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.

01

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.

  1. 1Trouver la syntaxeChoisissez la section qui correspond à votre besoin.
  2. 2Copier l’exempleCopiez le code Markdown et adaptez son contenu.
  3. 3Tester le renduVérifiez l’exemple dans la destination où il sera publié.
Titres

Créer des titres avec #

Utilisez d’un à six signes # suivis d’une espace.

# Titre principal
## Section
### Sous-section

Ré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.
Texte

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.
Mise en valeur

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.
Listes

Créer des listes à puces

Utilisez -, * ou + suivis d’une espace. Indentez les sous-éléments.

- Premier
- Deuxième
  - Sous-élément

Ré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.
Listes

Créer une liste numérotée

Ajoutez un nombre, un point et une espace.

1. Première étape
2. Deuxième étape

Ré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.
Images

Ajouter une image et son texte alternatif

Ajoutez ! devant la syntaxe de lien. Décrivez l’image avec précision.

![Aperçu d’un tableau Markdown](image.png)

Résultat : Image avec texte alternatif

  • Respectez exactement la syntaxe montrée dans l’exemple.
  • Vérifiez le rendu dans la destination finale.
Citations

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.
Code

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.
Code

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.
Structure

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.
Texte

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.
GFM

É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 un tableau Markdown
GFM

Créer une liste de tâches

Ajoutez [ ] ou [x] après le marqueur de liste.

- [x] Écrire
- [ ] Relire

Ré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.
Syntaxe

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.
HTML

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.
HTML

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.
Compatibilité

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é.

Base / CommonMark

Titres, paragraphes, emphase, citations, listes, code, liens, images et séparateurs forment le socle portable.

Extensions GFM

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.