Convertir Markdown en HTML

Le Markdown est devenu le langage de formatage préféré des développeurs, rédacteurs et blogueurs grâce à sa simplicité. Convertir du Markdown en HTML permet d'utiliser votre contenu sur n'importe quel site web ou plateforme.

Le Markdown, créé par John Gruber en 2004, est un langage de balisage léger qui utilise des symboles simples pour formater le texte : # pour les titres, ** pour le gras, * pour l'italique, - pour les listes, etc. Le Markdown est utilisé par GitHub, Reddit, Stack Overflow, et de nombreux CMS. Notre convertisseur transforme cette syntaxe en code HTML propre et valide.

Les dialectes du Markdown, ou pourquoi le même texte donne deux résultats

Le Markdown n'a pas une spécification unique, et c'est la première source d'étonnement quand un document rendu correctement à un endroit s'affiche autrement ailleurs. La version originale, publiée en 2004, était volontairement minimale et comportait de nombreuses zones d'ombre. Elle ne disait rien de ce qu'il fallait faire dans quantité de cas limites, chaque implémentation tranchant à sa façon. CommonMark est né de cette situation : une spécification rigoureuse qui décrit précisément le comportement attendu dans chaque cas, y compris les plus tordus. C'est aujourd'hui la référence commune de la plupart des outils sérieux. Par-dessus, plusieurs dialectes ajoutent des fonctionnalités. Le plus répandu est celui de GitHub, qui apporte les tableaux, le texte barré, les listes de tâches à cocher et la détection automatique des adresses web. Ces éléments sont si courants qu'on les croit volontiers natifs — mais un convertisseur strictement conforme à CommonMark ne les reconnaît pas, et les affichera comme du texte ordinaire. La conséquence pratique : si votre tableau ne se convertit pas, ce n'est pas forcément une erreur de syntaxe, c'est peut-être que l'outil ne prend pas en charge cette extension. Vérifiez le dialecte avant de chercher la faute dans votre document.

Le HTML au milieu du Markdown, et la question de la sécurité

Le Markdown autorise le HTML brut dans le corps du document. C'est une fonctionnalité assumée depuis l'origine : dès que la syntaxe simplifiée ne suffit plus, on écrit directement la balise. Cette souplesse a une conséquence directe sur la sécurité, souvent négligée. Convertir du Markdown en HTML puis afficher le résultat dans une page revient à laisser l'auteur du texte injecter le HTML de son choix — balises de script comprises. Sur un contenu que vous écrivez vous-même, aucun problème. Sur un contenu venu d'un formulaire, d'un commentaire ou d'un import, c'est une faille d'injection classique. La parade ne consiste pas à désactiver le HTML dans le Markdown, ce qui priverait de la fonctionnalité, mais à nettoyer le HTML produit avant de l'insérer dans une page : conserver les balises de mise en forme, retirer les scripts, les gestionnaires d'événements et les adresses en pseudo-protocole. Cette étape de nettoyage est distincte de la conversion et vient toujours après elle. Un second point relève de la mise en forme plutôt que de la sécurité. À l'intérieur d'un bloc HTML, le Markdown cesse généralement d'être interprété : du texte entouré d'astérisques placé dans une division restera avec ses astérisques au lieu de passer en gras. Les implémentations divergent sur ce point, et c'est une cause fréquente de rendu partiel quand on mélange les deux syntaxes dans un même document.

• Utilisez ```code``` pour les blocs de code avec coloration syntaxique
• Les images :  et les liens : [texte](url)
• Le Markdown est parfait pour versionner du contenu avec Git

Questions supplémentaires