Ce que fait l’outil
Le convertisseur HTML vers Markdown transforme du balisage HTML en Markdown propre et lisible. Utilisez-le pour migrer des articles de blog d’un CMS vers un générateur de site statique, rédiger des README à partir de pages existantes, enregistrer de la documentation sous forme de notes ou préparer du contenu pour un wiki, une issue GitHub ou une messagerie qui comprend Markdown.
La sortie suit les conventions courantes de Markdown : titres avec #, éléments de liste avec -, blocs de code délimités avec le langage d’origine, ainsi que tableaux et texte barré GitHub Flavored Markdown. Le texte est échappé si nécessaire pour que rien ne devienne du formatage par erreur.
Utilisation
- Collez du HTML dans le champ, importez un fichier
.htmlou cliquez sur Exemple. - Ajustez le style si votre projet a une convention : puce de liste, blocs de code délimités ou indentés, marqueurs d’italique et de gras, liens en ligne ou par référence.
- Copiez le Markdown ou téléchargez-le en fichier
.md.
Exemple
Ce HTML :
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul><li>Windows</li><li>macOS</li></ul>
devient ce Markdown :
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
Conseils
- Vous copiez depuis un navigateur ? Utilisez le code source ou les outils de développement pour récupérer seulement le HTML de l’élément article, afin que menus et pieds de page restent hors du résultat.
- Les liens par référence sortent les longues URL du texte, ce qui rend le Markdown plus facile à lire et à modifier. Les URL sont listées à la fin.
- Les images
data:intégrées sont supprimées par défaut car elles peuvent peser des centaines de kilo-octets. Activez l’option pour les garder. - Pour la conversion inverse, utilisez le convertisseur Markdown vers HTML ou affichez le résultat dans l’aperçu Markdown.
FAQ
› Quels éléments HTML sont convertis ?
Titres, paragraphes, gras, italique, barré, liens, images, listes ordonnées et non ordonnées (y compris imbriquées), citations, code en ligne, blocs de code avec leur langage, lignes horizontales, sauts de ligne et tableaux. Les tableaux deviennent des tableaux GitHub Flavored Markdown.
› Que deviennent les scripts, les styles et le head de la page ?
Ils sont supprimés. script, style, noscript, template, svg, iframe et toute la section head ne produisent pas de Markdown ; vous pouvez coller le code source d'une page complète et n'obtenir que son contenu lisible.
› Et le HTML que Markdown ne sait pas exprimer ?
Les balises inconnues sont retirées et leur texte est conservé. Les attributs comme les classes, les styles en ligne et les ID sont abandonnés, car Markdown n'a pas de syntaxe pour eux. Un bloc de code garde son langage quand l'élément code a une classe comme language-js.
› Pourquoi certains caractères sont-ils précédés d'une barre oblique inverse ?
Le texte qui deviendrait sinon du formatage Markdown, comme une ligne commençant par 1. ou des mots entre astérisques, est échappé pour que le Markdown s'affiche exactement comme le texte HTML d'origine.
› Le HTML est-il téléversé ?
Non. La conversion s'exécute dans votre navigateur avec un analyseur HTML en JavaScript, rien n'est envoyé à un serveur.