Markdown est une façon d'écrire du texte mis en forme avec du texte brut. Quelques symboles deviennent des titres, des listes, des liens et du code, et le résultat se convertit en HTML. Il est utilisé par GitHub, les fichiers README, les sites de documentation, les forums et les applications de notes. Prévisualisez le vôtre dans le Prévisualiseur Markdown. Chaque ligne ci-dessous a été rendue avec un processeur Markdown pour confirmer qu'elle fonctionne.
L'essentiel
| Vous tapez | Vous obtenez |
|---|---|
# Heading 1<br>## Heading 2 |
Titres : un à six signes # |
bold |
Gras |
italic |
Italique |
text |
Lien |
|
Image (le texte entre crochets est le texte alternatif) |
- item<br>- item |
Liste à puces (-, * ou +) |
1. first<br>2. second |
Liste numérotée |
> quoted |
Citation |
`code` |
Code en ligne |
```<br>code block<br>``` |
Bloc de code délimité (ajoutez un langage après la première clôture pour la coloration) |
--- |
Ligne horizontale |
| a | b |<br>|---|---|<br>| 1 | 2 | |
Tableau (une extension dans certains processeurs ; pris en charge par la plupart) |
Conseils
- Laissez une ligne vide entre les paragraphes, avant les listes et autour des blocs de code.
- Terminez une ligne par deux espaces (ou une barre oblique inverse dans certains processeurs) pour un saut de ligne sans nouveau paragraphe.
- Indentez un élément de liste imbriqué de deux à quatre espaces.
- Échappez un symbole avec une barre oblique inverse pour l'afficher tel quel, comme dans
\*pas italique\*. - Le HTML brut fonctionne en général dans Markdown, mais certains sites le suppriment par sécurité.
Les variantes diffèrent
Le Markdown d'origine est minimal. La plupart des plateformes ajoutent des extensions : GitHub Flavored Markdown ajoute les tableaux, les listes de tâches (- [ ] tâche), le barré (~~texte~~) et les liens automatiques ; d'autres ajoutent notes de bas de page, listes de définitions ou mathématiques. Si quelque chose ne s'affiche pas, vérifiez quelle variante le site utilise.
Convertir
Convertissez le Markdown en HTML avec n'importe quel processeur, et l'inverse avec le Convertisseur HTML vers Markdown ou le CSV vers Tableau Markdown pour les tableaux.