Convertisseur

Convertisseur Markdown en HTML

Convertisseur Markdown en HTML est un convertisseur de navigateur qui transforme le CommonMark et le GitHub Flavored Markdown en HTML assaini — titres, tableaux, listes de tâches et blocs de code inclus. Rien n'est envoyé ; le même moteur s'exécute derrière POST /v1/convert/markdown/html.

# markitdown-ai

Convert documents to clean Markdown.

## Features

- PDF, Word, and slides
- [x] Tables stay tables
- [ ] Mermaid coming later

## Install

```bash
pnpm add @markitdown-ai/sdk
```

## API

| Method | Path |
| --- | --- |
| POST | /v1/convert/{name} |
| GET | /v1/conversions/{id} |

Comment faire

Comment convertir du Markdown en HTML

Ce que vous pouvez coller

  • Tout Markdown : CommonMark plus les tableaux, listes de tâches et texte barré du GitHub Flavored Markdown
  • Le rendu s'exécute dans votre navigateur — rien n'est envoyé pendant la saisie
  • Aucun compte nécessaire pour prévisualiser, copier ou télécharger
  • Aucune limite de taille fixe ; un très gros document est borné par la mémoire de votre navigateur
Convertisseur Markdown en HTML : éditeur Markdown à gauche devenant une page HTML rendue à droite

Pourquoi l'utiliser

Pourquoi utiliser ce convertisseur Markdown en HTML

Un champ de CMS, un site statique et un éditeur d'e-mail veulent tous du balisage, pas du Markdown source. Ce convertisseur conserve les parties porteuses de sens et retire ce qui rendrait le HTML brut dangereux.

S'exécute dans votre navigateur

Collez du Markdown et l'aperçu HTML se met à jour localement. Rien n'est envoyé, et aucun compte n'est requis pour prévisualiser, copier ou télécharger.

CommonMark plus GFM

Titres, listes, liens, citations et blocs de code suivent CommonMark ; les tableaux, listes de tâches et le texte barré suivent le GitHub Flavored Markdown.

Assaini par défaut

Les balises script, les gestionnaires d'événements en ligne et les schémas href ou src non sûrs sont retirés, donc le HTML peut être collé sans risque dans une page que vous ne contrôlez pas entièrement.

Fragment ou document complet

Copiez seulement le balisage rendu pour une page qui gère déjà sa mise en page, ou téléchargez un document HTML complet avec le style de l'aperçu.

Ancres de titres

Chaque titre reçoit un identifiant stable et compatible URL, généré comme le fait l'API, pour qu'une table des matières ou un lien profond continue de fonctionner après publication.

Même moteur que l'API

Cet aperçu et POST /v1/convert/markdown/html utilisent le même moteur de rendu, donc le HTML copié ici correspond octet pour octet à un appel automatisé.

Le problème

Pourquoi le Markdown brut ne peut pas aller directement dans une page web

La syntaxe Markdown n'est pas du HTML

Un champ de CMS, un modèle d'e-mail ou un thème de site statique veulent du balisage, pas du Markdown source, donc le texte brut doit être converti avant de pouvoir être stylé ou intégré.

Un analyseur simple ignore GFM

Les tableaux, les listes de tâches et le texte barré sont des extensions du GitHub Flavored Markdown ; un analyseur limité à CommonMark les rend comme des barres verticales et des tildes littérales au lieu de structure.

Un Markdown non fiable peut porter des scripts

Le Markdown peut intégrer du HTML brut, notamment des balises <script> et des gestionnaires d'événements en ligne, qu'il faut retirer avant que la sortie soit sûre à insérer dans une page que vous ne contrôlez pas entièrement.

Convertir Markdown en HTML : texte copié-collé désordonné à côté d'une structure Markdown propre

Ce qui est conservé

Ce que ce convertisseur Markdown en HTML conserve

Titres et texte en ligne
Les titres ATX et setext, l'emphase, les liens et les citations suivent CommonMark ; chaque titre reçoit aussi un identifiant compatible URL généré à partir de son texte.Source: CommonMark Spec
Tableaux, listes de tâches et texte barré
Les tableaux GitHub Flavored Markdown deviennent des éléments <table>, les éléments [ ] et [x] deviennent des cases à cocher, et ~~texte~~ devient <del>.Source: GitHub Flavored Markdown Spec
Balisage assaini
Les balises <script> brutes, les gestionnaires d'événements en ligne et les valeurs href ou src hors http, https et mailto sont retirés avant que le HTML ne soit renvoyé.Source: HTML Living Standard
Blocs de code
Les blocs de code clôturés conservent leur contenu et leur étiquette de langage ; aucun thème de coloration syntaxique n'est appliqué par l'aperçu du navigateur lui-même.Source: CommonMark Spec
HTML brut dans la source
Le Markdown qui intègre d'autres balises HTML brutes passe par le même assainisseur, donc une balise intégrée n'est jamais traitée comme du balisage de confiance.Source: HTML Living Standard

Extrait vérifié de Markdown en HTML· https://markitdown.ai/blog/why-pdfs-break-llms

<h2 id="what-actually-goes-wrong">What actually goes wrong</h2><p>When teams pipe documents straight into an LLM or a retrieval index, a few failure modes show up again and again:</p><ul><li><strong>Reading order breaks.</strong> Multi-column layouts interleave. A two-column page becomes "line 1 left, line 1 right, line 2 left, line 2 right…", so a sentence a human reads top-to-bottom arrives at the model scrambled.</li><li><strong>Tables collapse.</strong> Copy-paste turns a table into a loose run of numbers. The relationship between a header and its cell — the entire point of a table — is gone.</li><li><strong>Headings disappear.</strong> The visual hierarchy (this is a section, this is a subsection) is encoded as font size and weight, not structure. Strip the styling and you get one undifferentiated wall of text.</li><li><strong>Noise creeps in.</strong> Page numbers, running headers, hyphenated line breaks, and stray ligatures end up inline, polluting prompts and embeddings alike.</li></ul><p>Read more in the <a href="https://markitdown.ai/blog/why-pdfs-break-llms">full article</a>.</p>

Cas d'usage

Cas d'usage de la conversion Markdown en HTML

Partout où une destination veut du balisage alors que la source reste du Markdown, ce convertisseur est l'étape intermédiaire.

Documentation et sites statiques

Transformez un README ou un article de base de connaissances Markdown en HTML attendu par un générateur de site statique ou un champ de CMS.

Brouillons d'e-mails et de newsletters

Rédigez un message en Markdown, convertissez-le en HTML, puis collez le fragment dans l'éditeur d'e-mail depuis lequel vous envoyez réellement.

Nettoyer une réponse de LLM

ChatGPT, Claude et Gemini renvoient du Markdown ; convertissez-le en HTML quand la destination — un ticket, une page wiki — affiche du balisage plutôt que des astérisques brutes.

Développeurs automatisant le rendu

Appelez le point d'accès de rendu depuis un pipeline qui stocke du Markdown mais sert du HTML, sans ajouter une bibliothèque Markdown à chaque service.

Markdown en HTML en ligne : page HTML rendue utilisée dans des sites, e-mails et documents

API

API Markdown en HTML pour les développeurs

Le rendu s'exécute de façon synchrone et coûte 0 crédit — il compte tout de même dans la limite de débit par minute de votre forfait. Envoyez du Markdown sous forme de texte, ou référencez un fichier .md stocké, à POST /v1/convert/markdown/html avec votre clé d'API ; le HTML assaini revient en ligne.

Lire le guide de l'API
curl -X POST https://api.markitdown.ai/v1/convert/markdown/html \  -H "x-api-key: mdai_…" \  -H "Content-Type: application/json" \  -d '{ "text": "# Notes\n\nHello **world**." }'

Documentation et sites statiques

La plupart des outils de documentation conservent le Markdown comme source modifiable et ne génèrent le HTML qu'au moment de la construction ou de l'aperçu. Ce convertisseur vous permet de vérifier cette étape de génération isolément : collez le même Markdown que lira votre générateur de site, et confirmez que les titres, les tableaux et les blocs de code ressortent comme votre thème l'attend avant de valider une modification. Il est aussi utile quand un champ de CMS accepte du HTML mais que vos rédacteurs travaillent en Markdown — convertissez une fois, collez le fragment, et continuez à modifier la source Markdown pour la révision suivante au lieu d'éditer à la main le balisage généré.

  • Gardez le fichier Markdown comme source de vérité ; traitez le HTML comme un artefact de construction.
  • Comparez la sortie rendue au thème réel de votre site, pas seulement au style d'aperçu de cette page.
  • Relancez la conversion après chaque modification de la source plutôt que de corriger à la main le HTML généré.

Assainissement

Le Markdown peut intégrer du HTML brut, et ce HTML brut peut contenir une balise <script> ou un gestionnaire d'événements en ligne comme onclick. Avant que ce convertisseur ne renvoie un résultat, ce balisage passe par un assainisseur qui supprime les éléments script, retire tout attribut commençant par "on", et n'autorise que les liens et sources d'images http, https et mailto. Ce qui survit, c'est la structure sémantique — titres, paragraphes, listes, tableaux, liens, images et code — pas le style décoratif. Le convertisseur n'injecte ni classe ni fichier CSS dans le fragment de sortie ; le téléchargement d'un document complet ajoute le thème que vous voyez dans l'aperçu, pour que le fichier s'ouvre correctement tout seul.

Fragment ou page complète

Un fragment est le balisage interne — les titres, les paragraphes et les tableaux — sans <html> ni <head> englobants. Il a sa place dans une page qui définit déjà sa propre structure de document et son style, comme un champ de contenu de CMS ou un composant qui rend des enfants. Un document complet ajoute un doctype, un titre et une petite feuille de style, pour que le fichier puisse être ouvert directement dans un navigateur ou enregistré seul. Coller un document complet dans un champ de contenu qui attend un fragment est une erreur courante : le navigateur peut encore l'afficher, mais les balises <html> et <head> imbriquées y sont invalides et peuvent perturber les outils en aval qui attendent un fragment.

FAQ

Questions sur Markdown en HTML

Comment fonctionne Markdown en HTML ?

Collez ou saisissez du Markdown et le convertisseur rend du HTML assaini localement dans votre navigateur, avec le même moteur que POST /v1/convert/markdown/html. Rien n'est envoyé pendant la saisie.

Markdown en HTML prend-il en charge le GitHub Flavored Markdown ?

Oui. Les tableaux, les listes de tâches et le texte barré suivent la spécification GitHub Flavored Markdown, aux côtés des titres, listes, liens et blocs de code CommonMark.

La sortie HTML est-elle assainie ?

Oui. Les balises script, les gestionnaires d'événements en ligne et les schémas href ou src non sûrs sont retirés, donc le HTML peut être collé sans risque dans une page que vous ne contrôlez pas entièrement.

Puis-je obtenir un document HTML complet au lieu d'un fragment ?

Oui. Choisissez un document complet avec le style de l'aperçu, ou copiez seulement le fragment pour une page qui gère déjà sa mise en page.

Ai-je besoin d'un compte pour convertir du Markdown en HTML ?

Non. L'aperçu, la copie et le téléchargement fonctionnent sans connexion, car le rendu s'exécute localement dans votre navigateur.

Cela appelle-t-il l'API pendant que je saisis ?

Non. La saisie reste locale. L'API ne s'exécute que lorsque vous appelez POST /v1/convert/markdown/html directement, par exemple depuis un script.

Y a-t-il une limite de taille pour le Markdown que je convertis ?

Il n'y a pas de limite d'envoi fixe puisque rien n'est envoyé ; les limites pratiques dépendent de la mémoire de votre navigateur pour de très gros documents.

Puis-je convertir du Markdown en HTML depuis du code ?

Oui. Envoyez votre Markdown sous forme de texte, ou un fichier .md stocké, à /v1/convert/markdown/html avec une clé d'API. Cela coûte 0 crédit. Voir /developers.

Convertissez du Markdown en HTML où vous voulez.

Essai gratuit — sans inscription.