Mode d’emploi

Saisissez du Markdown dans l’éditeur ou cliquez sur « Essayer un exemple » pour charger un document avec un tableau et une liste de tâches.
Observez l’aperçu se mettre à jour au fil de votre saisie. Passez à « Code source HTML » pour voir le balisage généré.
Activez ou désactivez le Markdown GitHub ou les sauts de ligne simples selon l’endroit où le texte sera publié.
Copiez le HTML dans un CMS ou un e-mail, ou téléchargez le résultat au format .html ou .md.

Fonctionnement

Markdown est converti avec marked, un analyseur open source largement utilisé, conforme à la spécification CommonMark et, lorsque l’option GFM est activée, au Markdown GitHub : tableaux avec des barres verticales et alignement des colonnes, listes de tâches, ~~texte barré~~ et liens automatiques pour les URL écrites en clair. Les notes de bas de page, les formules mathématiques et les diagrammes Mermaid ne font pas partie de ces spécifications et s’affichent en texte brut.

Markdown peut contenir du HTML brut, qui est transmis sans modification, comme le font la plupart des moteurs de rendu Markdown. Pour garantir votre sécurité, l’aperçu n’est jamais inséré dans cette page. Il est affiché dans un cadre isolé qui ne peut ni exécuter de scripts, ni envoyer de formulaires, ni ouvrir de fenêtres pop-up, ni accéder à ce site. Sa politique de sécurité du contenu bloque les scripts, les feuilles de style externes, les polices et les cadres. Une balise <script> ou un attribut onclick dans votre Markdown apparaît dans le code source HTML, mais n’est jamais exécuté. Les liens de l’aperçu sont affichés, mais ne s’ouvrent pas ; copiez l’URL si vous souhaitez la suivre.

L’aperçu utilise une feuille de style neutre, similaire à celles des moteurs de rendu de fichiers README courants ; votre site Web ou GitHub peut afficher différemment le même HTML. Le HTML copié est un fragment brut, sans styles ; le fichier .html téléchargé ajoute une feuille de style de base pour ressembler à l’aperçu. Le HTML téléchargé ou copié n’est pas assaini : s’il contient des scripts, ils s’exécuteront là où vous le collez ou l’ouvrez.

Exemples

Vérifier un README avant de le publier

Collez README.md pour vérifier l’alignement des colonnes du tableau, l’affichage de la liste de tâches sous forme de cases à cocher et la bonne délimitation des blocs de code, avant de publier le fichier sur GitHub.

Rédiger pour un CMS compatible avec le HTML

Rédigez un article de blog en Markdown, puis cliquez sur « Copier le HTML » et collez les balises <h2>, <p> et <ul> dans l’éditeur HTML de votre CMS.

Retours à la ligne façon messagerie

Le texte d’une application de messagerie comporte des lignes séparées par de simples sauts de ligne. Activez « Traiter les sauts de ligne simples comme des <br> » pour conserver ces retours à la ligne au lieu de fusionner le texte en un seul paragraphe.

Foire aux questions

Peut-on coller sans risque du Markdown provenant d’une source inconnue ?

Oui, pour l’aperçu. Le HTML généré s’affiche dans un cadre isolé où les scripts sont désactivés. Ainsi, même une balise <script> ou un gestionnaire d’événement dans le texte n’a aucun effet ici. Faites attention à l’endroit où vous collez le HTML exporté, car il n’est pas assaini.

Pourquoi mes images ne s’affichent-elles pas ?

Par défaut, les images d’autres sites Web sont bloquées afin que l’aperçu n’effectue aucune requête réseau. Activez « Charger les images d’autres sites Web » pour les afficher. Les chemins relatifs tels que ./docs/screenshot.png ne fonctionnent pas, car les fichiers ne se trouvent pas ici.

Les notes de bas de page, les formules mathématiques ou les diagrammes sont-ils pris en charge ?

Non. L’outil prend en charge CommonMark et le Markdown GitHub (tableaux, listes de tâches, texte barré, liens automatiques). Les notes de bas de page, les formules LaTeX et les diagrammes Mermaid sont des extensions qui s’affichent ici en texte brut.

Pourquoi un simple saut de ligne ne passe-t-il pas à la ligne suivante ?

En Markdown standard, un simple saut de ligne à l’intérieur d’un paragraphe est traité comme une espace. Terminez la ligne par deux espaces, insérez une ligne vide ou activez « Traiter les sauts de ligne simples comme des <br> ».

Confidentialité

Le Markdown est converti dans votre navigateur ; il n’est ni envoyé ni stocké. L’aperçu ne charge aucun contenu depuis Internet, sauf si vous autorisez les images d’autres sites Web ; dans ce cas, les images sont demandées directement à leurs serveurs.