Qu'est-ce que Markdown ? Une explication complète du langage de balisage léger
Réponse rapide
Markdown est un langage de balisage de texte brut qui utilise des symboles simples pour formater le texte : # pour les titres, ** pour le gras, * pour l'italique, - pour les listes, [text](url) pour les liens. Il est conçu pour être lisible sous forme de texte brut et convertible en HTML. Utilisez notre convertisseur gratuit Markdown vers HTML pour afficher Markdown dans votre navigateur.
Introduction
Markdown est un langage de balisage léger créé par John Gruber en 2004 qui utilise le formatage de texte brut pour produire des documents structurés. L'objectif est la lisibilité : le texte source Markdown doit ressembler à ce qu'il représente, sans l'encombrement visuel des balises HTML. Markdown est la norme pour les fichiers README sur GitHub, les sites de documentation, les articles de blog, les commentaires sur des plateformes comme Reddit et Stack Overflow et les applications de prise de notes comme Obsidian et Notion. Markdown se convertit en HTML pour la publication Web.
Pas à pas
-
Apprenez la syntaxe de base
Rubriques : #H1, ## H2, ### H3. Gras : **texte**. Italique : *texte*. Listes : - article ou 1. article. Liens : [texte](url). Images : . Code : `inline` ou ```block```. Citations : > citation. Règle horizontale : ---.
-
Comprendre la philosophie
Markdown est conçu pour être lisible sous forme de texte brut. La source doit ressembler à la sortie finale rendue : **gras** ressemble à du gras, # Heading ressemble à un titre. Cela contraste avec HTML, où les caractères <strong>gras</strong> et <h1>titre</h1> sont visuellement encombrés.
-
Apprenez les variantes
La démarque originale (spécification de Gruber) est minime. CommonMark est une version standardisée et bien spécifiée. GitHub Flavored Markdown (GFM) ajoute des tableaux, des barrés, des listes de tâches et des liens automatiques. MDX vous permet d'intégrer des composants React dans Markdown. La plupart des outils prennent en charge GFM.
-
Convertir Markdown en HTML
Markdown est converti en HTML pour la publication Web. # Bonjour devient <h1>Bonjour</h1>, **gras** devient <strong>gras</strong>. Les générateurs de sites statiques (Astro, Hugo, Jekyll) convertissent Markdown au moment de la construction. Utilisez notre convertisseur Markdown en HTML pour une conversion instantanée.
Exemples
Titre et paragraphe
Saisir: # Titre
Un paragraphe.
Sortir: <h1>Title</h1>
<p>A paragraph.</p>
Gras et italique
Saisir: **gras** et *italique*
Sortir: <strong>bold</strong> and <em>italic</em>
Lien et image
Saisir: [text](https://example.com) and 
Sortir: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Problèmes courants
- Sauts de ligne : une seule nouvelle ligne dans Markdown ne crée pas de saut de ligne dans HTML. Utilisez deux espaces à la fin d'une ligne ou deux nouvelles lignes pour un saut de paragraphe.
- Listes imbriquées : l'indentation est importante. Utilisez systématiquement 2 ou 4 espaces pour les éléments imbriqués ; les mélanger peut briser la structure de la liste.
- Raw HTML — la plupart des analyseurs Markdown passent par raw HTML, mais certains le nettoient. Vérifiez le comportement de votre analyseur si vous intégrez directement HTML.
- Différentes versions : Original Markdown, CommonMark et GFM présentent des différences subtiles. Vérifiez quelle version prend en charge votre plate-forme cible.
Conseils
- Utilisez Markdown pour l'écriture et la documentation : il est beaucoup plus facile à lire et à écrire que HTML.
- GitHub Flavored Markdown (GFM) est la variante la plus courante : elle ajoute des tableaux, des barrés et des listes de tâches.
- Écrivez en Markdown et convertissez-le en HTML au moment de la construction pour les blogs et les sites de documentation.
- Utilisez notre convertisseur Markdown vers HTML pour afficher Markdown instantanément dans votre navigateur.