Syntaxe Markdown complète : Guide de référence avec exemples

3 novembre 2025 • 12 min de lecture

Markdown est un langage de balisage léger créé pour formater du texte de manière simple et lisible. Ce guide complet vous présente toute la syntaxe Markdown avec des exemples pratiques pour maîtriser ce format devenu incontournable pour la rédaction de contenu technique. Tous les outils ne reconnaissent pas toutes les extensions : les paragraphes « Avec MD2PDF » indiquent ce que notre convertisseur prend en charge.

Les Titres

Les titres en Markdown s'écrivent avec des symboles #. Le nombre de # détermine le niveau du titre (de 1 à 6) :

# Titre de niveau 1 (H1)
## Titre de niveau 2 (H2)
### Titre de niveau 3 (H3)
#### Titre de niveau 4 (H4)
##### Titre de niveau 5 (H5)
###### Titre de niveau 6 (H6)

Conseil : Utilisez un seul H1 par document (le titre principal) et structurez le reste avec H2, H3, etc. pour créer une hiérarchie claire.

Avec MD2PDF : cinq niveaux de titres, de # à #####. Un titre ###### s'imprime comme un paragraphe ordinaire.

Mise en forme du texte

Gras et italique

**Texte en gras**
*Texte en italique*
***Texte en gras ET italique***
__Alternative pour le gras__
_Alternative pour l'italique_

Avec MD2PDF : écrivez le gras et l'italique avec des astérisques. L'italique avec des soulignés (_texte_) n'est pas reconnu : les soulignés s'impriment tels quels.

Texte barré et souligné

~~Texte barré~~

Note : Le barré est une extension (GitHub, GitLab, la plupart des éditeurs) ; le soulignement n'existe pas en Markdown standard. Avec MD2PDF, le barré n'est pas pris en charge.

Les listes

Listes à puces

- Premier élément
- Deuxième élément
  - Sous-élément (indenté avec 2 espaces)
  - Autre sous-élément
- Troisième élément

* On peut aussi utiliser des astérisques
+ Ou des symboles plus

Listes numérotées

1. Premier élément
2. Deuxième élément
3. Troisième élément
   1. Sous-élément numéroté
   2. Autre sous-élément

Listes de tâches (checkboxes)

- [x] Tâche terminée
- [ ] Tâche en cours
- [ ] Tâche à faire

Avec MD2PDF : puces - ou * sur trois niveaux, listes numérotées et listes de tâches sont prises en charge. Laissez une ligne vide avant une liste numérotée. Le texte d'un élément de liste s'imprime sans mise en forme : le gras, l'italique, le code et les liens y sont perdus.

Convertissez votre Markdown en PDF stylisé

Essayer MD2PDF →

Les liens

Lien hypertexte simple

[Texte du lien](https://www.example.com)

Lien avec titre (infobulle au survol)

[Texte du lien](https://www.example.com "Titre affiché au survol")

Lien de référence

[Texte du lien][ref]

[ref]: https://www.example.com "Titre optionnel"

Les images

Syntaxe de base

![Texte alternatif](chemin/vers/image.jpg)

Image avec titre

![Description](image.jpg "Titre de l'image")

Contrôler la taille (extension)

![Image](photo.jpg){width=50%}
![Petite image](icon.png){width=100px}

Avec MD2PDF : les images viennent de votre bibliothèque de médias (plans payants) et s'appellent par leur nom ou leur identifiant, avec une largeur en pourcentage si besoin : ![Légende](image:photo.jpg){width=50%}. Une image seule dans son paragraphe devient une figure centrée, avec sa légende en dessous. Les adresses d'images distantes ne sont pas prises en charge.

Les tableaux

| Colonne 1 | Colonne 2 | Colonne 3 |
|-----------|-----------|-----------|
| Donnée A1 | Donnée B1 | Donnée C1 |
| Donnée A2 | Donnée B2 | Donnée C2 |

Alignement des colonnes

| Gauche    | Centré    | Droite    |
|:----------|:---------:|----------:|
| Texte     | Texte     | Nombre    |
| abc       | def       | 123       |

- :--- = aligné à gauche
- :---: = centré
- ---: = aligné à droite

Les blocs de code

Code inline

Utilisez `const variable = "valeur"` pour du code dans le texte.

Blocs de code

```javascript
function hello(name) {
  console.log(`Bonjour ${name}!`);
}
```

```python
def hello(name):
    print(f"Bonjour {name}!")
```

```bash
npm install package-name
```

Le nom du langage (javascript, python, bash…) permet à GitHub, GitLab et à la plupart des éditeurs de colorer le code.

Avec MD2PDF : le code est imprimé tel quel, en police à chasse fixe, sans coloration syntaxique. Laissez une ligne vide avant les accents graves de fermeture, sinon la dernière ligne du bloc disparaît, et n'utilisez pas les blocs ouverts par ~~~, qui ne sont pas reconnus.

Les citations

> Ceci est une citation
> Sur plusieurs lignes
>
> > Citation imbriquée

Les séparateurs horizontaux

---
***
___

Tous ces trois formats créent une ligne horizontale de séparation.

Échappement de caractères

Pour afficher un caractère Markdown littéralement, utilisez l'antislash \ :

\*Ce texte n'est pas en italique\*
\# Ceci n'est pas un titre

HTML dans Markdown

Markdown accepte du HTML brut pour des mises en forme avancées :

<div style="color: red;">
  Texte en rouge
</div>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

Avec MD2PDF : le HTML est retiré à la conversion. Les balises disparaissent, seul leur texte reste.

Notes de bas de page

Voici un texte avec une note[^1].

[^1]: Ceci est le contenu de la note de bas de page.

Les notes de bas de page sont une extension, reconnue par GitHub et Pandoc notamment. Avec MD2PDF, elles ne sont pas prises en charge : intégrez la précision au texte, entre parenthèses.

Emojis

De nombreux éditeurs Markdown supportent les emojis avec la syntaxe :nom: ou directement en Unicode :

:smile: :rocket: :heart:
😊 🚀 ❤️

Avec MD2PDF : écrivez les emojis directement en Unicode ; ils sont imprimés en couleur, ou retirés si vous cochez l'option de suppression des emojis.

Définitions (extensions)

Terme
: Définition du terme

Autre terme
: Autre définition

Comparaison avec d'autres formats

Markdown vs HTML : Markdown est beaucoup plus lisible en mode brut, mais HTML offre plus de contrôle.
Markdown vs Word : Markdown est textuel (versionnable avec Git), Word est binaire.
Markdown vs LaTeX : Markdown est plus simple, LaTeX offre une précision typographique supérieure.

Outils et éditeurs Markdown

Visual Studio Code : Éditeur gratuit avec preview en temps réel
Typora : Éditeur WYSIWYG élégant (payant)
Obsidian : Prise de notes avec graphe de connaissance
Notion : Outil collaboratif avec support Markdown
GitHub/GitLab : Intégration native dans les README et wikis
MD2PDF : Conversion Markdown vers PDF avec personnalisation avancée

Bonnes pratiques

Une ligne vide entre les blocs : Séparez paragraphes, listes et titres par une ligne vide
Cohérence syntaxique : Choisissez un style et gardez-le ; les astérisques (*) fonctionnent partout, y compris avec MD2PDF
Indentation des listes : 2 ou 4 espaces selon votre éditeur
Noms de fichiers : Utilisez .md ou .markdown comme extension
Validation : Prévisualisez toujours le rendu avant publication

Ressources complémentaires

The Markdown Guide - Guide officiel complet
Markdown de John Gruber - Spécification originale
CommonMark - Standard Markdown unifié

Conclusion

La syntaxe Markdown est simple à apprendre mais puissante à utiliser. En quelques minutes, vous pouvez créer des documents structurés et lisibles. Associé à MD2PDF, vous pouvez ensuite transformer ces documents en PDFs professionnels avec une mise en page personnalisée, pour l'impression ou le partage.

Que vous rédigiez de la documentation technique, des articles de blog, ou des rapports, Markdown vous fait gagner un temps précieux en vous concentrant sur le contenu plutôt que sur la mise en forme.