Markdown en HTML

À propos de l’outil Markdown en HTML

L’outil Markdown en HTML transforme du Markdown en fichier HTML5 prêt à enregistrer, ou en fragment HTML à coller dans une page. Le texte est lu par marked avec GitHub Flavored Markdown activé (tableaux, listes de tâches, texte barré, et adresses écrites telles quelles qui deviennent des liens), et les notes de bas de page écrites [^1] sont numérotées et listées à la fin. Par défaut, le résultat est placé dans un doctype, un élément html, un head qui déclare l’encodage UTF-8 et un body ; « Titre », « Langue (lang) » et « Styles de base » ajoutent un titre, un attribut lang et une feuille de style, et « Fragment HTML (body seulement) » dans « Sortie » retire cette enveloppe. Les blocs de code gardent leur langage comme classe (language-js) et les caractères comme < dans le code sont échappés. Le HTML brut de votre Markdown est recopié sans changement, scripts compris, sauf si vous cochez « Retirer les scripts et les gestionnaires d’événements », qui nettoie le HTML avec DOMPurify. « Aperçu » montre la page telle qu’un navigateur la dessine, scripts bloqués. Le Markdown peut être collé ou ouvert depuis un fichier .md, .markdown ou .txt.

Exemple

Sortie du code de conversion de la page pour un titre, du code en ligne et un bloc JavaScript délimité.

# Notes

Utilisez `a < b` dans le **code**.

```js
if (a < b) run();
```

<!DOCTYPE html>
<html>
<head><meta charset="utf-8"></head>
<body>
<h1>Notes</h1>
<p>Utilisez <code>a &lt; b</code> dans le <strong>code</strong>.</p>
<pre><code class="language-js">if (a &lt; b) run();
</code></pre>
</body>
</html>

Comment convertir du Markdown en fichier HTML

1. 1Collez votre Markdown dans la zone « Markdown », ou cliquez sur « Ouvrir un fichier » pour charger un fichier .md, .markdown ou .txt.
2. 2Choisissez la « Sortie » et, pour un document complet, remplissez « Titre » et « Langue (lang) » ou cochez « Styles de base » ; cochez ensuite les cases utiles, comme « Notes de bas de page » ou « Retirer les scripts et les gestionnaires d’événements ».
3. 3Cliquez sur « Convertir », qui devient disponible dès que la zone n’est plus vide.
4. 4Vérifiez le code dans « Sortie HTML » et la page dans « Aperçu », puis cliquez sur « Copier » ou utilisez « Télécharger » pour l’enregistrer sous document.html.

Formats et limites

Entrée

Texte Markdown, collé ou ouvert depuis un fichier .md, .markdown ou .txt, lu selon les règles CommonMark et GitHub Flavored Markdown, notes de bas de page comprises

Sortie

Un document HTML : doctype, un head qui déclare l’encodage UTF-8 et body, avec le titre, l’attribut lang et les styles de base que vous choisissez ; ou le HTML du body seul

Extensions

Tableaux, listes de tâches, texte barré et adresses changées en liens (GitHub Flavored Markdown, désactivable) ; notes de bas de page ; id des titres ; retours à la ligne simples gardés en éléments br sur demande

HTML brut

Recopié tel qu’il est écrit, ou nettoyé par DOMPurify quand « Retirer les scripts et les gestionnaires d’événements » est coché

Téléchargement

document.html

Où votre Markdown est converti

La conversion se fait dans votre navigateur : la bibliothèque marked est chargée la première fois que vous cliquez sur Convertir, DOMPurify la première fois que vous nettoyez le HTML, et votre Markdown comme le HTML obtenu ne sont jamais envoyés à nos serveurs. Dans l’aperçu, les images vers lesquelles pointe votre Markdown sont chargées depuis leurs propres sites, comme à l’ouverture du fichier. Si une erreur s’affiche dans la zone de sortie, son message nettoyé est envoyé à notre journal des erreurs avec le nom de l’outil ainsi que le nom et la version de votre navigateur, sans les textes cités ni les adresses, pour que nous puissions corriger le problème.

Questions fréquentes

Trucs et astuces

• ✓Cochez « Ancres des titres (id) » pour donner un id à chaque titre, comme le fait GitHub, afin qu’un lien comme #installation y mène directement.

Outils associés

• Markdown en PDF
• Formateur HTML
• HTML en PDF
• Formateur JSON