Convertisseur Markdown

Conversion Markdown ↔ HTML avec aperçu

Instructions d'utilisation

🚀 Démarrage rapide

  • Collez le contenu dans le champ de gauche
  • Choisissez le mode (→HTML ou →Markdown)
  • La conversion est automatique, le résultat apparaît à droite
  • Aperçu/Sortie HTML : Markdown → HTML rend KaTeX/Mermaid par défaut

📌 Cas d’usage courants

  • Blogs/Docs : vérifier rapidement le rendu et les couleurs
  • Emailing : coller le HTML exporté dans le corps du mail (styles inline recommandés)
  • Rich text → Markdown : nettoyer le rich text web/CMS pour le versionner
  • Docs techniques : rendre formules/diagrammes et exporter en une étape
  • Migration d’éditeur : harmoniser les différences entre dialectes Markdown
  • Wiki/KB : convertir des pages HTML en Markdown pour import
  • Changelog d’API : transformer HTML/descriptions en Markdown pour revue/PR

🎛️ Paramètres de conversion & rendu

  • Markdown → HTML rend KaTeX/Mermaid automatiquement
  • HTML → Markdown conserve/restaure la source, sans re‑rendu
  • GFM (tableaux/tâches) activé par défaut ; utilisez le Markdown standard pour un comportement strict
  • Retours doux activés ; pour un rendu strict, utilisez des lignes vides ou deux espaces en fin de ligne
  • Les contenus très volumineux peuvent activer un aperçu dégradé (rendu limité/désactivation du surlignage)

🧭 Conseils d’utilisation

  • Email : privilégiez les styles inline pour la compatibilité
  • Longs documents : convertissez par parties pour éviter les ralentissements

⚠️ Limites & Compatibilité

  • Variantes : le rendu varie selon les plateformes ; préférez la syntaxe commune
  • HTML → Markdown est au mieux : styles/mise en page souvent perdus
  • HTML → Markdown ignore certaines balises/attributs (scripts/styles/meta, intégrations/formulaires, médias, événements on*, style/class, etc.)
  • Tableaux complexes/emboîtements peuvent être simplifiés ; relisez
  • Images/vidéos restent en liens externes ; non téléchargées
  • Les SVG Mermaid pré‑rendus par des tiers ne sont pas fiables à inverser

🔒 Confidentialité & Sécurité

  • Tous les traitements s’effectuent dans votre navigateur ; aucune donnée ne quitte votre appareil
  • N’exécute pas les <script> collés
  • Rendu KaTeX/Mermaid avec configuration sûre
  • Pas de nettoyage HTML complet ; vérifiez avant/après conversion

❓ FAQ

L’aperçu diffère de la plateforme cible : comment diagnostiquer ?

Identifiez le dialecte cible (CommonMark/GFM/extension maison). Évitez le HTML brut et les extensions privées. Utilisez des retours standard (ligne vide ou deux espaces fin de ligne). Réduisez à un exemple minimal, validez sur la cible, puis élargissez.

Comment déployer en production un HTML exporté en toute sécurité ?

L’outil n’exécute pas <script>, mais ne nettoie pas automatiquement. Nettoyez côté serveur/pipeline avec une bibliothèque en liste blanche (p. ex. DOMPurify), interdisez on* et les schémas dangereux, et appliquez une CSP pour scripts externes/en ligne.

HTML → Markdown déforme des structures complexes : que faire ?

Préférez des sémantiques portables : transformez tableaux/listes imbriqués en tableaux pipe et listes plus plates ; collez en texte brut pour retirer span/style/class avant conversion ; isolez un cas minimal et ajustez la source.

Limites et dépannage KaTeX/Mermaid ?

Syntaxe : KaTeX $$…$$ ou en ligne $…$ ; Mermaid en bloc ```mermaid. Gros contenus : aperçu dégradé (source/cul des activée). Réduisez la densité, convertissez par parties, et utilisez des cas minimaux. Récupération : KaTeX depuis le HTML rendu ; Mermaid seulement pour les diagrammes générés par l’outil avec source intégrée.

Convertisseur Markdown - Convertir, Aperçu, Coloration Code - CrateX.app