Convertir Markdown en HTML

Du Markdown à une vraie page web

Le Markdown permet aux développeurs, rédacteurs et preneurs de notes de mettre en forme du texte sans traitement de texte : # pour les titres, astérisques pour l'emphase, tirets pour les listes. Il est idéal pour écrire, mais les navigateurs, les outils d'e-mail et beaucoup d'éditeurs de CMS ont besoin de HTML.

Ce convertisseur analyse votre fichier avec marked, un moteur Markdown très répandu, en syntaxe GitHub Flavored Markdown. Le résultat est un document HTML5 complet avec déclaration UTF-8, un titre tiré de votre premier titre et une petite feuille de style lisible : le fichier est agréable dès le double clic.

Markdown ou HTML : comparaison rapide

Comment convertir du Markdown en HTML

1. 1

   Étape 1: Choisissez un fichier .md

   Déposez un README, un fichier de notes ou un brouillon d'article. Du texte copié ? Enregistrez-le d'abord en fichier .md.

2. 2

   Étape 2: Gardez HTML comme sortie

   HTML est présélectionné. PDF et TXT sont aussi disponibles.

3. 3

   Étape 3: Convertissez

   Le Markdown est analysé puis intégré dans une page HTML complète.

4. 4

   Étape 4: Téléchargez et ouvrez

   Ouvrez le fichier .html dans un navigateur, ou copiez le contenu du body dans votre CMS.

Fonctions Markdown prises en charge

À quoi sert la conversion Markdown en HTML

• Publier des notes. Partagez un export Obsidian ou Notion sous forme de page web unique.

• Aperçu de README. Voyez à peu près le rendu d'un README avant de le pousser.

• Contenu de CMS et de newsletter. Collez le HTML généré dans les éditeurs qui acceptent le HTML.

• Documentation hors ligne. Donnez à vos collègues un fichier qui s'ouvre dans n'importe quel navigateur.

À quoi ressemble le HTML généré

Les titres deviennent des éléments h1 à h6, les listes des ul et ol, les tableaux des éléments table avec cellules d'en-tête, et les blocs de code des pre et code avec une classe comme language-js. Les retours à la ligne dans un paragraphe suivent les règles du Markdown : un simple retour ne crée pas de saut, sauf si la ligne se termine par deux espaces ou une barre oblique inverse.

Le HTML brut présent dans votre Markdown est conservé tel quel, comme sur GitHub. C'est utile pour des blocs details ou des intégrations, mais la sortie n'est alors pas plus sûre que le Markdown fourni.

Utiliser le résultat sur votre site

Si vous n'avez besoin que du contenu, copiez tout ce qui se trouve entre les balises body et collez-le dans votre modèle ou votre CMS. La feuille de style incluse est facultative et ne vise que les éléments de base : une fois retirée, elle n'interfère pas avec votre site.

Les liens et chemins d'images relatifs restent relatifs. Gardez le fichier HTML dans la même arborescence que le Markdown pour que les images continuent de s'afficher.

• Page complète : ouvrez le fichier directement.
• Fragment : copiez le contenu du body dans votre éditeur.
• Style : remplacez la petite feuille de style intégrée par la vôtre.

Conseils pour vos fichiers Markdown

• Commencez le fichier par un titre # : il devient le titre de la page.
• Laissez une ligne vide avant les listes et les tableaux pour que tous les moteurs les reconnaissent.
• Utilisez des blocs de code délimités avec un nom de langage pour faciliter la coloration.
• Vérifiez les liens après conversion : les liens .md ne sont pas réécrits en .html.

Questions sur la conversion Markdown en HTML