Devenu le format de fait pour la documentation technique (README, wikis, tickets), le Markdown doit son succès à sa simplicité — au prix de quelques limites qu'il vaut mieux connaître.
Le Markdown a été conçu pour rester lisible même non converti — un fichier .md ouvert dans un simple éditeur de texte reste compréhensible, contrairement à du HTML brut noyé de balises. C'est cette propriété qui en a fait le standard de facto sur GitHub, GitLab, de nombreux wikis et outils de tickets : on écrit vite, sans quitter le clavier pour des menus de mise en forme, et le résultat reste lisible à la fois en source et une fois rendu.
| Syntaxe | Rendu |
|---|---|
# Titre | Titre de niveau 1 (jusqu'à ###### pour niveau 6) |
**gras** / *italique* | Texte en gras / italique |
- élément | Liste à puces |
1. élément | Liste numérotée |
[texte](url) | Lien hypertexte |
`code` | Code inline |
| ``` bloc ``` | Bloc de code multi-lignes |
> citation | Citation en bloc |
Le Markdown couvre volontairement un sous-ensemble réduit de mise en forme — pas de contrôle fin des couleurs, de la mise en page complexe, ou des animations. Pour ces besoins, la plupart des moteurs de rendu Markdown (GitHub inclus) acceptent d'insérer directement du HTML brut au milieu du Markdown, comblant le manque ponctuellement sans abandonner le format pour autant.
Il existe plusieurs "saveurs" de Markdown (CommonMark, GitHub Flavored Markdown, etc.) qui ajoutent des extensions non universelles (tableaux, listes de tâches - [ ]) — un document qui s'affiche bien sur GitHub peut rendre différemment ailleurs si le moteur cible ne supporte pas les mêmes extensions.
Convertir du Markdown maintenant →
Oui, ainsi que les titres, listes (à puces et numérotées), citations, liens, images, gras/italique/barré et le code inline — les extensions Markdown les plus utilisées dans la documentation technique courante.
Dans la plupart des cas oui, mais certains CMS appliquent leur propre nettoyage du HTML collé — vérifie le rendu final après collage, certains attributs ou balises pouvant être filtrés.
Chaque moteur de rendu Markdown a ses propres choix d'implémentation pour les cas ambigus de la spécification — la syntaxe de base (titres, gras, listes) est universelle, mais les détails fins peuvent varier légèrement d'un moteur à l'autre.
Outils similaires