Le guide complet de Markdown

Markdown est un langage de balisage léger que vous pouvez utiliser pour ajouter des éléments de mise en forme à des documents en texte brut. Créé par John Gruber en 2004, Markdown est aujourd’hui l’un des langages de balisage les plus populaires au monde.

Syntaxe de base

Titres

# H1
## H2
### H3
#### H4
##### H5
###### H6

Emphase

*Texte en italique* ou _Texte en italique_
**Texte en gras** ou __Texte en gras__
***Gras et italique*** ou ___Gras et italique___
~~Texte barré~~

Listes

Listes non ordonnées

- Premier élément
- Deuxième élément
- Troisième élément
  - Élément indenté
  - Autre élément indenté

Listes ordonnées

1. Premier élément
2. Deuxième élément
3. Troisième élément
  1. Élément indenté
  2. Autre élément indenté

Liens et images

[Texte du lien](https://www.example.com)
![Texte alternatif](image.jpg)

Code

Code en ligne

Utilisez `code` dans votre texte

Blocs de code

```javascript
const hello = "world";
console.log(hello);
```

Citations

> Ceci est une citation
> 
> Elle peut s’étendre sur plusieurs lignes

Règles horizontales

---
***
___

Syntaxe étendue

Tableaux

| Syntaxe | Description |
| ----------- | ----------- |
| En‑tête | Titre |
| Paragraphe | Texte |

Listes de tâches

- [x] Rédiger le communiqué de presse
- [ ] Mettre à jour le site web
- [ ] Contacter les médias

Notes de bas de page

Voici une phrase avec une note de bas de page. [^1]

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

Emoji

:smile: :heart: :rocket:

Surlignage

==highlighted text==

Bonnes pratiques

1. Rester simple : Markdown est conçu pour être facile à lire et à écrire.
2. Utiliser une mise en forme cohérente : conservez un style unique pour des éléments similaires.
3. Ajouter des espaces : utilisez des lignes vides pour séparer les sections.
4. Bien structurer les titres : commencez par H1 puis descendez dans la hiérarchie.
5. Échapper les caractères spéciaux : utilisez un antislash pour échapper les caractères spéciaux.

Pièges courants

• Oublier d’ajouter un espace après les titres
• Mal indenter les listes imbriquées
• Mélanger différents marqueurs de listes
• Ne pas échapper les caractères spéciaux quand nécessaire

Outils et ressources

• Guide Markdown
• Fiche mémo Markdown
• Dillinger - Éditeur Markdown en ligne
• Aperçu Markdown - Outil d’aperçu en direct

Conclusion

Markdown est un outil puissant pour créer des documents bien formatés rapidement et efficacement. Que vous écriviez de la documentation, preniez des notes ou créiez du contenu pour le web, Markdown offre une manière simple et efficace de structurer votre texte.

Rappel : la meilleure façon d’apprendre Markdown est de pratiquer ! Essayez de créer vos propres documents et d’expérimenter différentes syntaxes.