Titres et paragraphes
Les titres avec #
En Markdown, les titres se créent avec le symbole #. Plus il y a de #, plus le titre est petit.
# Titre principal (H1)
## Titre de section (H2)
### Titre de sous-section (H3)
#### Encore plus petit (H4)Ce que ça donne en rendu :
Titre principal (H1)
Titre de section (H2)
Titre de sous-section (H3)
Encore plus petit (H4)
Mets un espace entre le # et le texte. #Titre ne fonctionne pas. # Titre fonctionne.
Combien de niveaux utiliser ?
En pratique, 3 niveaux suffisent pour la majorité des documents :
#— Le titre principal du document. Un seul par page.##— Les grandes sections.###— Les sous-sections à l'intérieur d'une section.
Un exemple concret — la structure d'un README :
# Mon projet
## Installation
### Prérequis
### Étapes
## Utilisation
## ContribuerLes paragraphes
Un paragraphe, c'est du texte séparé par une ligne vide.
Premier paragraphe. Il peut faire
plusieurs lignes sans problème.
Deuxième paragraphe. La ligne vide
entre les deux crée la séparation.Premier paragraphe. Il peut faire plusieurs lignes sans problème.
Deuxième paragraphe. La ligne vide entre les deux crée la séparation.
Retour à la ligne simple
Attention : un retour à la ligne simple ne crée pas de nouveau paragraphe.
Ligne 1
Ligne 2Ces deux lignes seront collées en rendu : Ligne 1 Ligne 2.
Pour forcer un retour à la ligne sans créer un nouveau paragraphe, ajoute deux espaces à la fin de la ligne, ou utilise une ligne vide.
Les deux espaces de fin de ligne sont invisibles. En pratique, utiliser une ligne vide est plus simple et plus lisible.
Exemple complet
# Mes recettes préférées
## Pasta carbonara
La recette originale est italienne.
Elle n'utilise pas de crème fraîche.
### Ingrédients
- Pâtes
- Œufs
- Guanciale
- Pecorino
## Tarte aux pommes
Simple et rapide à faire.
### Ingrédients
- Pommes
- Pâte brisée
- Sucre#= H1,##= H2,###= H3 — espace obligatoire après le #- Un seul H1 par document
- Ligne vide = nouveau paragraphe
- Retour à la ligne simple = texte collé en rendu