Markdown en HTML

Le convertisseur Markdown vers HTML transforme la source Markdown - un README, un journal des modifications, un brouillon de blog, un ensemble de notes de version - en HTML qu'un navigateur ou un CMS restitue réellement Coller ou taper Markdown à gauche, et vous obtenez du HTML sémantique à droite : les titres deviennent h1h6, le code clôturé devient pré et le code avec une classe de langue, les listes deviennent ul et ol, et les extensions GitHub telles que les tables, les listes de tâches et les strikethrough sont gérées de la manière dont GitHub les restitue.

Markdown est un format d'écriture en texte brut, pas un format d'affichage N'importe où il apparaît sur une page - un site docs, un blog statique, un modèle de messagerie, un champ CMS qui n'accepte que le HTML - quelque chose doit d'abord le faire dans le navigateur, plutôt que de tirer un analyseur dans votre build ou de coller votre brouillon dans un service que vous ne contrôlez pas, est le moyen le plus rapide de faire sortir le balisage et de passer à autre chose.

Tout fonctionne côté client. Le convertisseur est un analyseur manuscrit, pas un wrapper autour d'une API distante, de sorte que vos publications non publiées, vos documents internes et vos notes de version privée ne quittent jamais la page. Basculez le démarquement des identifiants de GitHub, en en-tête les identifiants d'ancrage, les sauts de ligne à une seule ligne et le transfert HTML brut, puis copiez le code HTML, téléchargez un fichier .html ou récupérez une table de contenus générée.

Markdown permet une inline HTML brute, ce qui rend la question de sécurité réelle plutôt que théorique : un document contenant une balise de script est valide Markdown, et un convertisseur qui le fait passer produit du HTML qui s'exécutera lorsqu'il est rendu La sortie ici est échappée par défaut pour cette raison, donc un fichier Markdown d'une source non fiable ne peut pas faire passer de balisage en contrebande dans votre page Si vous êtes en train de convertir votre propre contenu et que vous voulez que le HTML brut soit préservé, c'est un choix délibéré plutôt que par défaut L'autre chose à savoir est que Markdown n'a pas une spécification GitHub Flavored Markdown est implémenté ici, qui couvre les tableaux, listes de tâches, strikes et code barrers, et non plus strictes.