Marquage vers HTML
Ce que Markdown à HTML fait
Écrire ou coller un marquage léger — en-têtes, listes, liens, clôtures de code — et prévisualiser la traduction HTML que votre temps d'exécution émet probablement. Les saveurs diffèrent : GitHub ajoute des tables et griffe ; CommonMark est plus strict sur l'indentation et la séparation des paragraphes. Les blocs HTML bruts à l'intérieur de Markdown passent toujours dans de nombreux pipelines – ne présumez jamais que la conversion désinfecte le texte fourni par l'utilisateur.
Quand l'utiliser
Utilisez-le lors de la création des prévisualisations README, le débogage CMS rend des imperfections, ou vérifier si les listes imbriquées nécessitent une indentation supplémentaire pour votre analyseur. Après le rendu en HTML, sanitize avant de stocker si les utilisateurs peuvent soumettre Markdown publiquement; combiner conceptuellement avecConvertisseur d'entités HTMLpour les snipets échappés etEnlèvement des balises HTMLlorsque vous avez seulement besoin d'une copie visible.
Exemple travaillé
Docs rend les listes de puces comme des blocs de code parce que chaque ligne a été dentelée quatre espaces. Voir Markdown-to-HTML côte à côte montre la spécification traitant l'indentation comme une plage de codes clôturés — fixer les lignes directrices d'auteur, et non la conjecture aléatoire d'exécution.
Foire aux questions
Ça correspond à mon CMS ?
Peut-être partiellement. Validez toujours avec le moteur Markdown exact de votre plateforme.
Images et HTTPS ?
Markdown lui-même ne réécrit pas les intégrations non sécurisées; les politiques CSP et de contenu mixte s'appliquent toujours.
Pourquoi les ancres ont-elles bougé ?
Les algorithmes pour les identifiants de position varient par rendeur — ne pas coder dur URLs d'ancrage à travers les systèmes.