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

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

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.

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_

Texte barré et souligné

~~Texte barré~~

Note : Le soulignement n'est pas supporté en Markdown standard.

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

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}

Astuce MD2PDF : Utilisez les attributs de largeur pour contrôler précisément l'affichage de vos images dans le PDF final.

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 avec coloration syntaxique

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

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

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

Langages supportés : javascript, python, java, php, ruby, go, rust, sql, bash, json, html, css, et bien d'autres.

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>

Notes de bas de page

Voici un texte avec une note[^1].

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

Emojis

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

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

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 (* ou _) et gardez-le
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.