Aperçu Markdown

Tapez ou collez du Markdown à gauche, le rendu s'affiche à droite au fil de la frappe. Quand le résultat vous convient, cliquez sur Copier le HTML pour placer le code généré dans le presse-papiers, ou sur Télécharger le HTML pour l'enregistrer sous markdown-output.html. Le rendu est assuré par pulldown-cmark, un parseur CommonMark écrit en Rust, et le HTML est nettoyé par l'assainisseur ammonia, tous deux compilés en WebAssembly. Vos brouillons sont rendus dans l'onglet et ne sont jamais envoyés à un serveur.

La syntaxe Markdown prise en charge

Le moteur suit CommonMark, la spécification standardisée du Markdown, avec trois extensions de GitHub Flavored Markdown activées :

• Titres : # à ######, ou soulignés avec === et ---.
• Emphase : *italique*, **gras** et ~~barré~~ (extension).
• Listes : puces -, * ou +, listes numérotées, listes imbriquées et listes de tâches - [ ] et - [x] (extension).
• Tableaux : tableaux à barres verticales avec une ligne de séparation comme |---|---| (extension).
• Code : accents graves en ligne, blocs délimités par trois accents graves ou tildes, blocs indentés.
• Liens et images : [texte](https://...), liens par référence, liens automatiques entre chevrons.
• Citations avec > et séparateurs avec ---.
• HTML brut dans le Markdown : accepté, puis assaini (voir plus bas).

Les notes de bas de page, les formules mathématiques, les diagrammes Mermaid et les ancres de titres ne font pas partie de ce moteur.

Prévisualiser et exporter

1. Rédigez ou collez votre Markdown. L'aperçu se met à jour une fraction de seconde après la dernière frappe, ce qui garde l'éditeur fluide sur les longs documents.
2. Vérifiez titres, listes imbriquées, tableaux et blocs de code dans l'aperçu : c'est là que les erreurs d'indentation sautent aux yeux.
3. Cliquez sur Copier le HTML pour le coller dans un CMS, un outil d'e-mailing ou un gabarit.
4. Ou cliquez sur Télécharger le HTML. Le fichier contient uniquement le fragment HTML (sans <head> ni styles), prêt à insérer dans une page.

Ce que l'assainisseur retire, et pourquoi

Le Markdown autorise le HTML brut : un document collé pourrait donc contenir un script. Avant tout affichage ou export, le HTML passe par un assainisseur :

• Retirés : les éléments <script> et <style>, les attributs style et class, les gestionnaires d'événements comme onclick ou onerror, et les commentaires HTML.
• Schémas de liens autorisés : http, https et mailto. Un lien javascript: est neutralisé.
• Les URL relatives sont supprimées. Un lien vers /docs/installation ou une image images/logo.png garde son texte mais perd sa cible. Utilisez des URL absolues si le HTML exporté doit conserver liens et images.
• Les classes de langage comme language-js sont retirées des blocs de code : ajoutez la coloration syntaxique dans votre destination.
• Les cases à cocher des listes de tâches sont retirées de la sortie ; le texte de l'élément reste.
• Chaque lien reçoit rel="noopener noreferrer".

Résultat : un HTML que vous pouvez insérer dans une page sans ouvrir de faille XSS, même si le Markdown provient d'un tiers.

Usages typiques

• Relire un README, un changelog ou la description d'une pull request avant de pousser.
• Écrire un article ou une newsletter en Markdown, puis coller le HTML dans un CMS ou un outil d'e-mailing qui n'accepte que le HTML.
• Transformer une documentation rédigée en Markdown en fragments HTML pour un centre d'aide.
• Comprendre pourquoi une liste ou un tableau s'affiche mal ailleurs, en comparant avec un rendu CommonMark de référence.

Par rapport aux éditeurs et générateurs de sites

VS Code, Obsidian ou Typora prévisualisent très bien le Markdown, et GitHub le fait dans son éditeur web. Pandoc ou un générateur de site statique produisent des pages HTML complètes. Cet outil couvre l'entre-deux : rien à installer, un rendu conforme à CommonMark, et un HTML copiable immédiatement. Les moteurs diffèrent sur les extensions : un document qui s'appuie sur des notes de bas de page ou des diagrammes s'affichera autrement ici que sur une plateforme qui les gère.

Confidentialité de vos brouillons

Un brouillon Markdown, c'est souvent du travail non publié : documentation interne, annonce sous embargo, comptes rendus de réunion, notes personnelles. Les éditeurs en ligne qui rendent côté serveur en reçoivent l'intégralité. Ici, le rendu et l'assainissement se font en WebAssembly dans la page, et le texte que vous tapez ne quitte jamais votre appareil.

Foire aux questions

Mon Markdown est-il envoyé à un serveur ?

Non. Le rendu s'exécute dans votre navigateur via WebAssembly. Rien n'est téléversé ni enregistré.

Le GitHub Flavored Markdown est-il pris en charge ?

Les tableaux, le texte barré et les listes de tâches de GFM le sont, en plus de CommonMark. D'autres fonctions propres à GitHub, comme les notes de bas de page, les mentions ou les raccourcis d'emoji, ne sont pas rendues.

Pourquoi mon lien relatif a-t-il disparu du HTML ?

L'assainisseur ne conserve que les URL absolues en http, https ou mailto. Les chemins relatifs sont retirés par sécurité. Écrivez des URL complètes si les liens doivent fonctionner dans l'export.

Puis-je mettre du HTML dans mon Markdown ?

Oui. Le HTML brut est rendu, après suppression des scripts, des styles, des gestionnaires d'événements et des attributs dangereux.

Mon texte est-il conservé d'une visite à l'autre ?

Non. Le contenu de l'éditeur n'est pas stocké. Copiez ou téléchargez votre travail avant de fermer l'onglet.

Peut-on convertir du HTML en Markdown ?

Oui, avec le convertisseur HTML vers Markdown. Pour une page dédiée au sens Markdown vers HTML, voyez le convertisseur Markdown vers HTML.

Outil connexe : comptez les mots et le temps de lecture de votre brouillon avec le compteur de mots.