Dans cet article
Qu'est-ce que Markdown ?
Markdown est un langage de balisage léger créé par John Gruber en 2004. Il utilise une syntaxe simple basée sur la ponctuation pour ajouter de la mise en forme au texte brut — les titres avec #, le gras avec **, les liens avec [texte](url) — qui se transforme en HTML formaté. Sa simplicité en a fait le standard universel pour la documentation des développeurs.
Markdown est utilisé partout : les fichiers README de GitHub, les réponses sur Stack Overflow, les messages Slack, les pages Notion, les sites de documentation et les plateformes de blog. La plupart des développeurs écrivent du Markdown quotidiennement sans même y penser.
Comment fonctionne l'aperçu Markdown
L'aperçu Markdown de CheckTown transforme votre Markdown en HTML en temps réel au fur et à mesure que vous tapez.
- Conformité CommonMark — affiche le Markdown standard selon la spécification CommonMark
- Extensions GFM — prend en charge GitHub Flavored Markdown, notamment les tableaux, les listes de tâches et le texte barré
- Coloration syntaxique — les blocs de code sont mis en évidence pour les langages de programmation courants
Essayez gratuitement — sans inscription
Prévisualiser du Markdown →Quand utiliser l'aperçu Markdown
L'aperçu Markdown est utile dans tout processus d'écriture où vous devez vérifier le rendu avant de publier.
- Fichiers README — rédigez et prévisualisez les fichiers README.md avant de les pousser sur GitHub
- Documentation — rédigez et prévisualisez la documentation technique avant de la publier sur des sites de docs
- Articles de blog — composez vos articles en Markdown et prévisualisez le rendu formaté
Foire aux questions
Quelle est la différence entre les variantes de Markdown ?
La spécification Markdown d'origine laissait de nombreux cas ambigus non définis, ce qui a conduit à de multiples implémentations incompatibles. CommonMark est une spécification standardisée qui résout ces ambiguïtés. GitHub Flavored Markdown (GFM) étend CommonMark avec des tableaux, des listes de tâches et des liens automatiques. La plupart des plateformes utilisent soit CommonMark, soit GFM.
Markdown peut-il inclure du HTML brut ?
Oui, la plupart des processeurs Markdown permettent d'intégrer des balises HTML directement dans les documents Markdown. Cela est utile pour une mise en forme avancée non prise en charge par la syntaxe Markdown. Cependant, de nombreuses plateformes assainissent le HTML pour des raisons de sécurité, et le HTML brut peut donc être supprimé dans les contextes de contenu généré par les utilisateurs.
Comment créer un tableau en Markdown ?
Les tableaux utilisent des barres verticales et des tirets : | En-tête 1 | En-tête 2 | sur la première ligne, | --- | --- | sur la deuxième ligne pour le séparateur, puis les lignes de données. L'alignement des colonnes est contrôlé par la position des deux-points dans le séparateur : :--- pour gauche, :---: pour centré, ---: pour droite.