Comment utiliser l’éditeur
- Écrivez du Markdown ou ouvrez un fichier .md.
- Utilisez la barre d’outils : gras, italique, titre, listes, code, lien, image, tableau.
- Choisissez l’affichage : éditeur seul, côte à côte ou aperçu seul.
- Options : sauts de ligne en <br> et défilement synchronisé.
- Exportez : copiez le Markdown ou le HTML, téléchargez le .md ou le .html.
Qu’est-ce que le Markdown ?
Le Markdown est un langage de balisage léger créé par John Gruber en 2004. Au lieu de mettre en forme à la souris, on tape quelques caractères directement dans le texte : astérisques pour le gras, dièses pour les titres, tirets pour les listes. Le texte reste lisible même sans mise en forme, se modifie avec n’importe quel éditeur et se versionne avec Git. Le Markdown est la norme pour les fichiers README sur GitHub et GitLab, la documentation, les wikis, les applications de notes comme Obsidian, les générateurs de sites statiques et les forums.
Les commandes essentielles
| Markdown | Résultat |
|---|---|
# Titre, ## Sous-titre | titres de niveau 1 et 2 |
**gras**, _italique_, ~~barré~~ | mise en valeur du texte |
- élément, 1. élément, - [ ] tâche | liste à puces, numérotée, de tâches |
[texte](https://…),  | lien, image |
`code`, bloc ``` | code en ligne, bloc de code |
> citation, --- | citation, séparateur |
Barre d’outils et raccourcis
Sélectionnez du texte puis cliquez sur une icône pour le mettre en forme, ou utilisez les raccourcis Ctrl+B pour le gras, Ctrl+I pour l’italique et Ctrl+K pour un lien (Cmd sur Mac). Les commandes de liste et de citation s’appliquent à toutes les lignes sélectionnées. Le bouton tableau insère une structure de trois colonnes à compléter. La touche Tab insère une indentation au lieu de quitter le champ.
GitHub Flavored Markdown
L’éditeur suit la variante répandue GFM définie par GitHub. Elle ajoute au Markdown d’origine les tableaux, les listes de tâches avec cases à cocher, le texte barré, les liens détectés automatiquement et les blocs de code délimités. Les titres reçoivent automatiquement des ancres, pour créer des liens internes. Avec l’option « Sauts de ligne en <br> », chaque retour à la ligne simple est conservé, comme dans les commentaires GitHub ; sans elle, un nouveau paragraphe nécessite une ligne vide.
Export HTML
« Copier le HTML » fournit le code HTML de l’aperçu, par exemple pour le coller dans un CMS ou un éditeur de newsletter. « Télécharger le .html » crée un fichier HTML complet et autonome, avec un style sobre et lisible, à ouvrir dans le navigateur, à envoyer par e-mail ou à imprimer. Les liens de l’aperçu s’ouvrent dans un nouvel onglet.
Brouillon et statistiques
Votre texte est enregistré automatiquement dans le navigateur et reste disponible après la fermeture de l’onglet. Il n’est envoyé à aucun serveur. Sous l’éditeur s’affichent les mots, caractères, lignes et le temps de lecture estimé à environ 230 mots par minute, pratique pour des articles ou une documentation soumis à une longueur.
Le Markdown au quotidien
Le Markdown ne sert pas qu’aux développeurs. De nombreuses applications de notes comme Obsidian, Notion ou Bear l’utilisent, des outils de messagerie comme Slack, Microsoft Teams, Discord ou Mattermost comprennent une partie de sa syntaxe, et des plateformes comme Reddit ou Stack Overflow l’emploient pour les messages. Une fois les quelques règles connues, on met en forme bien plus vite qu’à la souris. Pour la documentation, les fichiers texte se versionnent avec Git et se transforment en sites soignés avec MkDocs, Docusaurus ou Hugo. Conseil : laissez une ligne vide avant et après les titres, listes et blocs de code pour un rendu identique partout.
Questions fréquentes
Quelle variante de Markdown est prise en charge ?
Le GitHub Flavored Markdown, avec tableaux, listes de tâches, texte barré et blocs de code.
Comment créer un tableau ?
Avec le bouton tableau ou avec des barres verticales | et une ligne de séparation faite de tirets.
Mon texte est-il enregistré ?
Oui, comme brouillon local dans votre navigateur. Il n’est pas envoyé en ligne.
Puis-je exporter en HTML ?
Oui, en code à copier ou en fichier .html complet.
L’éditeur est-il gratuit ?
Oui, sans inscription.