Comment convertir du HTML en Markdown
- Collez un fragment HTML ou importez un fichier
.htmlpris en charge. - Convertissez la source et examinez quels éléments sémantiques restent significatifs dans Markdown.
- Convertissez et inspectez les liens, les images, les listes imbriquées, les tableaux et les blocs de code.
- Copiez le Markdown ou téléchargez le fichier
.md.
Que préserve le convertisseur ?
| Contenu source | Comportement de sortie recommandé | Note de conversion |
|---|---|---|
| En-têtes | Associer <h1>–<h6> aux en-têtes Markdown | |
| Paragraphes et emphase | Convertir les paragraphes, le texte en gras et en italique | |
| Listes | Convertir les listes ordonnées, non ordonnées et imbriquées | |
| Liens | Préserver le texte et l'URL résolue | |
| Images | Préserver la source et le texte alternatif | |
| Code | Utiliser le code en ligne et les blocs de code délimités | |
| Tableaux | Convertir les tableaux compatibles en GFM | |
| Citations | Convertir les citations sémantiques |
Qu'est-ce qui peut changer pendant la conversion ?
Scripts, styles et formulaires
Les éléments exécutables et interactifs n'ont pas d'équivalent Markdown ordinaire et peuvent être omis ou réduits à du texte.
Tableaux complexes
Les fusions de lignes (rowspans), de colonnes (colspans), les tableaux imbriqués et le contenu riche des cellules peuvent nécessiter du HTML brut ou un aplatissement.
URLs relatives
Un fragment collé peut ne pas inclure l'URL de base de la page, de sorte que les liens relatifs et les chemins d'accès aux images ne peuvent pas toujours être résolus.
Conteneurs de mise en page
Les mises en page div, grid et flexbox n'impliquent pas d'ordre de lecture sémantique.
Contenu masqué et standard (boilerplate)
Le convertisseur a besoin d'une politique claire concernant les éléments masqués, la navigation et le contenu visuellement réduit.
Utilisations courantes de HTML en Markdown
Migrer de la documentation Web
Transférez du code HTML sémantique dans un système de documentation basé sur Markdown.
Nettoyer du texte enrichi copié
Convertissez le HTML généré par l'éditeur dans un format plus simple avant de procéder à la gestion de version ou à la publication.
Préparer des exemples de code
Conservez les blocs de code et les en-têtes sans importer la feuille de style complète de la page.
Créer un contexte d'IA textuel
Supprimez les scripts et les styles tout en conservant la structure des informations qui doit encore être examinée.
Exemple de HTML en Markdown
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- TestConseils pour un rendu Markdown plus propre
- Utiliser du HTML sémantique Les en-têtes, les listes et les tableaux se convertissent de manière plus fiable que les conteneurs de mise en page génériques.
- Fournir une URL de base si nécessaire Les liens relatifs nécessitent un contexte si le résultat doit fonctionner en dehors de la page d'origine.
- Choisir un dialecte de sortie Le format GFM prend en charge les tableaux et les listes de tâches que le CommonMark de base ne définit pas.
- Vérifier les blocs de code Confirmez le langage de programmation détecté et les accents graves (backticks) intégrés.
- Décider de la solution de repli en HTML brut Conserver le HTML non pris en charge peut préserver les informations mais réduit la portabilité.
Foire aux questions
Les éléments <script> et <style> sont-ils supprimés ?
Les scripts et les styles ne constituent pas un contenu Markdown utile et ne doivent pas être pris en compte dans le résultat. Examinez le code HTML collé avant de réutiliser la sortie.
Les tableaux HTML sont-ils convertis en tableaux Markdown ?
Les tableaux rectangulaires compatibles peuvent devenir des tableaux GFM. Les tableaux avec rowspan, colspan, des blocs imbriqués ou plusieurs lignes d'en-tête nécessitent une solution de repli documentée.
Les blocs de code et le code en ligne sont-ils préservés ?
Ils peuvent être mis en correspondance à partir de <pre> et <code>.
Qu'advient-il des liens et des images ?
Le texte de lien et les destinations valides peuvent être conservés. Les liens relatifs et les chemins d'accès aux images restent dépendants du contexte car un fragment importé n'a pas d'URL de base garantie.
Les balises HTML non prises en charge sont-elles supprimées ou conservées ?
Les conteneurs de présentation uniquement peuvent être simplifiés tout en conservant le texte lisible. Comparez la sortie avec la source lorsque les éléments personnalisés ont une signification.
Le convertisseur génère-t-il du CommonMark ou du GFM ?
La sortie prévue est du GitHub-Flavored Markdown. Les tableaux, le texte barré et les listes de tâches reposent sur les extensions GFM.
Puis-je coller un document HTML complet ?
Oui. Vous pouvez coller un fragment ou importer un fichier .html ou .htm, puis examiner le Markdown généré.
Cette page peut-elle convertir l'URL d'un site Web en direct ?
Non. Cette page accepte du code HTML collé ou un fichier HTML importé ; elle ne récupère pas l'URL d'un site Web en direct.
Convertir le Markdown en PDF
Vous avez déjà un fichier Markdown ? Utilisez leconvertisseur Markdown en PDFpour créer un PDF partageable.