Syntaxe des titres Markdown

Les titres sont les éléments les plus importants pour organiser la structure d'un document. Markdown prend en charge deux syntaxes de titres : le style ATX et le style Setext.

Titres de style ATX

Pour créer un titre, ajoutez un dièse (#) avant un mot ou une phrase. Le nombre de dièses indique le niveau du titre.

# Titre niveau 1
## Titre niveau 2  
### Titre niveau 3
#### Titre niveau 4
##### Titre niveau 5
###### Titre niveau 6

Rendu

Titre niveau 1

Titre niveau 2

Titre niveau 3

Titre niveau 4

Titre niveau 5

Titre niveau 6

Syntaxe de fermeture optionnelle

Vous pouvez « fermer » un titre ATX, ce qui est purement esthétique :

# Titre niveau 1 #
## Titre niveau 2 ##
### Titre niveau 3 ###

Le nombre de # à la fin n'a pas besoin de correspondre au début : seul le nombre au début détermine le niveau du titre.

Titres de style Setext

Vous pouvez aussi ajouter une ligne de = sous le texte pour un titre de niveau 1, ou une ligne de - pour un titre de niveau 2.

Titre niveau 1
===============

Titre niveau 2
---------------

Rendu

Titre niveau 1

Titre niveau 2

Bonnes pratiques pour les titres

Compatibilité

S'il n'y a pas d'espace entre le dièse (#) et le texte du titre, les applications Markdown peuvent se comporter différemment. Pour la compatibilité, ajoutez un espace entre le dièse et le texte.

✅ Recommandé	❌ Non recommandé
# Ceci est un titre	#Ceci est un titre

Utilisation des lignes vides

Pour la compatibilité, ajoutez des lignes vides avant et après les titres.

Ceci est un paragraphe.

# Ceci est un titre

Ceci est un autre paragraphe.

Niveaux de titres

• Chaque document doit utiliser un seul titre de niveau 1
• Gardez une hiérarchie logique des niveaux ; ne sautez pas de niveaux
• Les titres doivent refléter la structure hiérarchique du document

Conseils pour le texte des titres

• Le texte du titre doit être concis et clair
• Évitez la ponctuation (surtout les points)
• Utilisez des noms ou des groupes nominaux
• Gardez une mise en forme cohérente pour les titres d'un même niveau

Sortie HTML

Les titres Markdown sont convertis en balises HTML correspondantes :

# Titre       →  <h1>Titre</h1>
## Titre      →  <h2>Titre</h2>
### Titre     →  <h3>Titre</h3>
#### Titre    →  <h4>Titre</h4>
##### Titre   →  <h5>Titre</h5>
###### Titre  →  <h6>Titre</h6>

ID de titre (fonctionnalité étendue)

De nombreux moteurs Markdown génèrent automatiquement des ID pour les titres, ce qui permet de créer des liens d'ancrage :

<h1 id="syntaxe-des-titres-markdown">Syntaxe des titres Markdown</h1>

Cela permet de créer un lien vers un titre précis :

[Lien vers le titre](#syntaxe-des-titres-markdown)

Exemple pratique

Voici un exemple de document avec une hiérarchie de titres bien structurée :

# Manuel utilisateur

## Démarrage rapide

### Étapes d'installation

#### Prérequis système

#### Télécharger et installer

### Configuration de base

## Fonctionnalités avancées

### Paramètres personnalisés

### Gestion des plugins

## Dépannage

### FAQ

### Contacter le support

Une structure de titres claire rend le document facile à lire et à parcourir.

Syntaxes associées

• Paragraphes et retours à la ligne
• Listes
• Liens