Éditeur Markdown

Cet éditeur Markdown en ligne affiche votre texte à gauche et le résultat mis en forme à droite, et l’aperçu se met à jour à chaque frappe. Il comprend le Markdown utilisé sur GitHub, dans les fichiers README, les wikis et les applications de notes comme Obsidian : titres, listes, listes de tâches, tableaux, code, citations, liens, images et notes de bas de page. Vous n’avez pas besoin de compte et rien de ce que vous saisissez n’est envoyé nulle part.

Comment utiliser l’éditeur Markdown en ligne

1. Saisissez ou collez du Markdown dans le champ de gauche, ou ouvrez un fichier .md avec le bouton de fichier de la barre d’outils. Vous pouvez aussi déposer un fichier n’importe où sur l’éditeur.
2. Suivez l’aperçu à droite. Défilement synchronisé maintient les deux côtés sur la même partie du document quand vous faites défiler l’un ou l’autre.
3. Mettez le texte en forme avec la barre d’outils ou avec des raccourcis comme Ctrl+B pour le gras et Ctrl+K pour un lien.
4. Copiez le résultat en Markdown, en HTML ou en texte enrichi, ou téléchargez-le en fichier .md, .pdf, .docx, .html ou .txt.

L’éditeur s’ouvre avec un court exemple intitulé « Notes de projet » qui utilise tous les éléments courants : vous voyez ainsi la syntaxe et son résultat côte à côte avant d’écrire votre propre texte.

Éditeur Markdown avec aperçu en direct

Trois vues se trouvent au-dessus de l’éditeur. Côte à côte place le Markdown et l’aperçu l’un à côté de l’autre, Édition donne toute la largeur au texte et Aperçu n’affiche que le résultat, ce qui en fait un lecteur Markdown simple pour visualiser un fichier que quelqu’un vous a envoyé. Sur un téléphone, l’éditeur bascule entre Édition et Aperçu, car deux colonnes seraient trop étroites pour être lisibles.

L’aperçu est rendu de la même façon que GitHub affiche le Markdown : CommonMark avec les extensions GitHub Flavored Markdown (tous deux en anglais), qui ajoutent les tableaux, les listes de tâches, le texte barré et les liens automatiques. Les titres reçoivent des ancres comme sur GitHub : ## Plan de publication peut donc être lié avec #plan-de-publication, et un clic sur un tel lien fait défiler l’aperçu jusqu’au titre. Les notes de bas de page écrites [^1] sont numérotées dans l’ordre de leur première mention et listées à la fin.

Le champ de texte utilise le correcteur orthographique de votre navigateur, les mots mal orthographiés sont donc soulignés pendant que vous écrivez. Sous l’éditeur, vous voyez le nombre de mots et de caractères ainsi que le temps de lecture. Ces décomptes ne tiennent pas compte de la syntaxe Markdown : un titre marqué par ## ne compte que ses mots. Pour compter aussi les phrases et les paragraphes, collez le texte dans le compteur de mots et de caractères.

Barre d’outils et raccourcis clavier

La barre d’outils couvre tout ce dont vous avez besoin pour un document courant : Titre, Gras, Italique, Barré, Code en ligne, Lien, Image, Citation, Bloc de code, Liste à puces, Liste numérotée, Liste de tâches, Tableau et Ligne horizontale. Sélectionnez d’abord du texte et le bouton l’entoure ; appuyez à nouveau sur le même bouton et les marqueurs disparaissent. Sans sélection, le bouton insère un court texte provisoire déjà sélectionné, il suffit donc de taper par-dessus.

Quelques détails font gagner du temps :

• Titre fait passer la ligne courante par #, ##, ###, puis la ramène au texte simple.
• Lien transforme les mots sélectionnés en [mots](https://) et sélectionne la partie adresse : il ne reste plus qu’à coller l’URL. Si vous sélectionnez plutôt une URL, elle devient l’adresse.
• Les boutons de liste et Citation agissent sur toutes les lignes sélectionnées à la fois. Un clic sur Liste numérotée dans une liste à puces la transforme en liste numérotée.
• Appuyez sur Enter à la fin d’un élément de liste et l’élément suivant commence par le bon marqueur. La numérotation se poursuit, une nouvelle tâche commence non cochée, et Enter sur un élément vide termine la liste. Tab et Shift+Tab augmentent et diminuent le retrait des éléments de liste.
• Chaque modification faite par un bouton ou un raccourci peut être annulée avec Ctrl+Z.

Tous les raccourcis sont listés sous Raccourcis clavier, en dessous de l’éditeur. Sur un Mac, ils utilisent la touche Commande.

Coller depuis Word ou Google Docs et obtenir du Markdown

Lorsque vous collez du texte copié depuis Word, Google Docs ou une page web, l’éditeur convertit sa mise en forme en Markdown au lieu de la perdre. Les titres deviennent des lignes #, le texte en gras et en italique reçoit ses astérisques, les liens gardent leurs adresses, les listes à puces et numérotées (y compris les listes à plusieurs niveaux de Word) deviennent des listes Markdown, et les tableaux deviennent des tableaux Markdown dont la première ligne sert d’en-tête. C’est le moyen le plus rapide de transférer un document existant dans un README ou une page de wiki.

Si vous vouliez seulement le texte, cliquez sur Utiliser plutôt le texte brut dans la note qui apparaît après le collage, ou collez avec Ctrl+Shift+V. Le code copié depuis VS Code ou un autre éditeur de code, ainsi que le texte qui est déjà du Markdown, sont collés tels quels.

Aide-mémoire de la syntaxe Markdown

La syntaxe la plus courante en un coup d’œil. Tapez la colonne de gauche dans l’éditeur pour voir la colonne de droite dans l’aperçu.

Vous tapez	Vous obtenez
# Titre, ## Section, ### Sous-section	Des titres de niveau 1 à 3 (jusqu’à 6 avec ######)
**gras** et *italique*	gras et italique
~~ancien~~	ancien
`code`	code dans une police à chasse fixe
[texte](https://example.com)	un lien
	une image
- élément ou 1. élément	une liste à puces ou numérotée
- [ ] tâche et - [x] fait	une liste de tâches avec des cases à cocher
> texte cité	une citation
trois accents graves sur une ligne avant et après le code	un bloc de code
--- seul sur sa ligne	une ligne horizontale
texte[^1] et [^1]: note	une note de bas de page

Un tableau Markdown a besoin d’une ligne d’en-tête, d’une ligne de séparation faite de tirets, puis d’une ligne par rangée, avec les cellules séparées par |. Un deux-points dans la ligne de séparation définit l’alignement : :-- aligne à gauche, :-: centre et --: aligne à droite. Le bouton Tableau insère un tableau de trois colonnes prêt à remplir. Les cellules n’ont pas besoin d’être alignées dans la source, mais les aligner rend le tableau plus facile à modifier ensuite.

Markdown accepte aussi le HTML pour ce qu’il ne sait pas écrire avec sa propre syntaxe, comme <kbd>Ctrl</kbd> pour les touches, <sub> et <sup> pour H₂O et x², ou <details> pour une section qui s’ouvre au clic. Les scripts, les styles et les formulaires sont retirés de l’aperçu par sécurité.

Copier en texte enrichi ou télécharger le fichier

Copier le Markdown copie la source, Copier le HTML copie un HTML propre, prêt pour un site web ou un CMS, et Copier en texte enrichi copie le résultat mis en forme. Collez-le dans Google Docs, Word, Outlook ou Gmail : les titres, le texte en gras, les listes, les liens et les tableaux conservent leur mise en forme, sans aucun symbole Markdown.

Les boutons Télécharger enregistrent le document en Markdown, PDF, Word, HTML ou texte brut en un clic, sous un nom tiré du titre de son front matter ou de son premier titre. Ils utilisent des réglages par défaut raisonnables : papier A4 (Lettre US aux États-Unis, au Canada, au Mexique et dans les autres pays où c’est la norme), marges normales et texte en corps 11. Pour choisir le format de page, les polices et les marges, ajouter une table des matières ou convertir plusieurs fichiers à la fois, utilisez Plus d’options d’exportation, qui ouvre le convertisseur Markdown avec votre texte déjà chargé.

Questions fréquentes

Mon texte est-il envoyé ou enregistré quelque part ?

Non. L'aperçu, la conversion et les téléchargements se font tous dans votre navigateur, et le texte n'est jamais envoyé à un serveur. Par défaut, rien n'est stocké non plus : le texte disparaît quand vous fermez l'onglet. Si vous cochez Conserver le brouillon dans ce navigateur, le texte est enregistré dans le stockage de votre propre navigateur après chaque modification et revient lors de votre prochaine visite. Décochez cette case sur un ordinateur partagé, ce qui supprime aussi le brouillon enregistré.

Comment ouvrir et visualiser un fichier .md en ligne ?

Cliquez sur le bouton de fichier de la barre d'outils ou déposez le fichier sur l'éditeur, puis passez à Aperçu pour le lire comme un document mis en forme. Les fichiers jusqu'à 20 Mo en UTF-8 ou UTF-16 s'ouvrent directement. Les images du fichier s'affichent quand elles ont une adresse web complète ; une page web ne peut pas charger les images enregistrées à côté du fichier sur votre ordinateur.

Quelle variante de Markdown l'éditeur utilise-t-il ?

Il suit CommonMark (en anglais), le standard sur lequel s'accordent la plupart des outils Markdown, ainsi que les extensions de GitHub : tableaux, listes de tâches, texte barré, liens automatiques et notes de bas de page. Un texte écrit pour GitHub, GitLab, Obsidian, Reddit ou Discord s'affiche ici de la même façon, à part les fonctions que ces services ajoutent par-dessus, comme les mentions d'utilisateurs ou les liens wiki d'Obsidian.

Comment mettre du Markdown dans Google Docs ?

Cliquez sur Copier en texte enrichi et collez dans le document. Les titres, les listes, les liens et les tableaux gardent leur mise en forme. Les versions récentes de Google Docs savent aussi lire le Markdown elles-mêmes avec Édition, Coller à partir de Markdown, une fois Markdown activé dans Outils, Préférences.

L'éditeur prend-il en charge les diagrammes Mermaid ou les formules LaTeX ?

Pas encore. Un bloc Mermaid s'affiche comme un bloc de code ordinaire, et les formules écrites sous la forme $...$ restent du texte brut. Tout le reste de GitHub Flavored Markdown est pris en charge.

Qu'est-ce que Markdown et qui l'utilise ?

Markdown est une façon de mettre en forme du texte brut avec quelques symboles, créée par John Gruber en 2004 pour qu'un document reste lisible avant même d'être converti en HTML (plus d'informations sur Wikipédia). Les développeurs l'utilisent pour les fichiers README et la documentation, les auteurs pour leurs notes et leurs brouillons, et les outils de chat IA répondent dans ce format, ce qui explique pourquoi leurs réponses sont pleines d'astérisques et de dièses une fois collées ailleurs.

D’autres outils pour le texte se trouvent dans la catégorie Texte : comparez deux versions d’un document pour voir ce qui a changé, ou changez la casse des titres en une seule fois. Les développeurs trouveront le formateur JSON et d’autres outils dans la catégorie Développeurs.