Markdown vers HTML

Comment ça marche

Écrivez ou collez votre texte dans le panneau de gauche ; la sortie se forme à droite au fil de la frappe. La conversion est confiée à un analyseur Markdown éprouvé, si bien que l'outil reconnaît toute l'écriture courante : titres de un à six, gras et italique, texte barré, code en ligne et blocs de code encadrés, listes imbriquées, listes de tâches (une espace ou un x entre crochets), tableaux, citations, images, filets horizontaux et adresses écrites telles quelles. Si votre texte contient déjà du HTML, il reste du HTML, mais après un passage par un filtre de sécurité qui retire les balises de script, les attributs d'événement et les adresses qui exécutent du code au clic. La ligne de résultat compte ce qui a été trouvé et indique, le cas échéant, combien d'éléments ont été retirés. Deux formes de sortie sont proposées : le HTML de corps se colle dans une page existante, la page complète donne un fichier qui s'ouvre seul.

Cet outil est aussi connu sous le nom de markdown to html, convertir markdown en html, md vers html, tableau markdown html.

Qu'est-ce que Les signes du Markdown ?

En Markdown, la mise en forme s'exprime non par des balises mais par des signes de ponctuation placés en début de ligne ou autour du texte : le nombre de dièses donne le niveau de titre, deux astérisques mettent en gras, un seul en italique, l'accent grave indique du code, et une ligne commençant par un chevron fermant est une citation. C'est une convention, non une norme officielle unique ; les moteurs s'accordent sur le cœur et divergent dans le détail.

Qu'est-ce que GFM (Markdown façon GitHub) ?

Le GFM est le dialecte de Markdown le plus répandu ; il ajoute quatre choses à l'écriture de base : les tableaux tracés à la barre verticale, les listes de tâches entre crochets, le texte barré entre doubles tildes, et la mise en lien automatique d'une adresse écrite au fil d'une phrase. La majeure partie du Markdown écrit aujourd'hui relève de ce dialecte, et cet outil le reconnaît.

Qu'est-ce que Assainissement du HTML ?

Assainir du HTML, c'est en retirer les parties dangereuses avant de le poser sur une page : balises de script, attributs accrochés aux événements de clic ou de chargement, balises qui insèrent une page étrangère dans un cadre et adresses exécutant du code sont supprimés, tandis que le reste de la structure est conservé. La différence avec l'échappement est décisive : l'échappement transforme tout en texte, l'assainissement laisse les balises sûres jouer leur rôle de balises.

Qu'est-ce que HTML de corps ?

Le HTML de corps désigne les balises qui composent uniquement la partie contenu d'une page : titres, paragraphes, listes, liens. La déclaration de doctype, la section d'en-tête, le jeu de caractères et les appels de feuilles de style se trouvent hors de ce fragment, car ils appartiennent au squelette de la page. Le texte destiné à un système de gestion de contenu, à un gabarit de courriel ou à un éditeur de blog est généralement demandé sous cette forme.

Quelle est la différence entre Markdown et HTML ?

Tous deux font le même travail — donner une structure au texte — mais ne s'adressent pas au même destinataire. Le Markdown regarde l'humain : il se lit même sans traitement, s'écrit vite et reste propre dans l'historique des versions. Le HTML regarde le navigateur : chaque élément est une balise explicite, accepte des attributs et s'imbrique sans limite. C'est aussi pour cela que le Markdown fonctionne presque partout ; en bout de chaîne, il est converti en HTML. Cet outil accomplit cette dernière étape sans passer par un serveur.

Quelle écriture Markdown est reconnue ?

La base CommonMark, augmentée des ajouts de GitHub devenus courants partout. La liste ci-dessous rassemble ce qui sert vraiment ; tout ce qui n'y figure pas ressort en texte simple plutôt que de disparaître en silence.

Les retours à la ligne isolés ne coupent volontairement pas un paragraphe : les lignes écrites les unes sous les autres restent dans le même paragraphe, et une ligne vide en ouvre un nouveau. C'est pourquoi un texte collé depuis un courriel ou une application de notes ne part pas en morceaux.

• Titres, gras, italique, barré (~~ainsi~~)
• Code en ligne et blocs de code avec nom de langage
• Listes à puces et numérotées imbriquées ; listes de tâches
• Tableaux tracés à la barre verticale, avec leur ligne d'alignement
• Citations, filets horizontaux, images, liens
• Une adresse écrite dans le texte devient cliquable d'elle-même

Que devient le HTML présent dans votre texte ?

La définition même du Markdown autorise du HTML entre les paragraphes ; un bloc dépliant (details), une touche de clavier (kbd) ou un tableau écrit à la main passent en général par là. Cet outil les conserve, mais les fait d'abord traverser un nettoyeur éprouvé.

Le filtre retire tout ce qui pourrait faire exécuter du code au navigateur : balises de script, balises qui insèrent une page étrangère dans un cadre, attributs liés aux événements de clic et de chargement, adresses qui lancent du code. Deux balises supplémentaires tombent à dessein : le bloc de style et le formulaire. Le HTML de corps est collé à l'intérieur de la page de quelqu'un d'autre ; un bloc de style qui s'y glisse repeint la page entière, et un formulaire peut se muer en fausse zone de connexion.

Si quelque chose a été retiré, la ligne de résultat en donne le nombre. Vous apprenez donc qu'un élément a quitté votre texte sans avoir à comparer la sortie ligne à ligne.

Comment les adresses des liens sont-elles filtrées ?

C'est le schéma en tête d'adresse — la partie qui précède les deux points — qui est contrôlé. Les adresses web, de courriel, de téléphone, de message court et de serveur de fichiers passent ; celles qui exécutent du code au clic tombent sans bruit et le lien reste sans cible.

Les adresses relatives sont volontairement admises : un chemin commençant par une barre oblique, un nom de fichier du même dossier ou une ancre interne à la page comptent comme valides. Si vous collez la sortie dans votre propre site, c'est exactement ce qu'il vous faut.

Si vous avez vous-même donné une cible au lien (ouvrir dans un nouvel onglet, par exemple), elle est conservée ; les navigateurs récents ouvrent de toute façon ces liens de façon isolée.

HTML de corps ou page complète ?

La sortie de corps ne donne que les balises de contenu : c'est ce que l'on colle dans un gabarit existant, dans un système de gestion de contenu ou dans le corps d'un courriel.

L'option page complète produit un fichier HTML fonctionnel, avec déclaration de doctype, attribut de langue, jeu de caractères et balise de zone d'affichage. Le titre de la page reprend le premier titre de premier niveau du texte ; à défaut, un nom générique est écrit.

Questions fréquentes

Les balises HTML de mon texte sont-elles conservées ?

Oui, mais après filtrage. Les blocs dépliants, les touches de clavier ou les tableaux que vous avez écrits restent des balises dans la sortie ; scripts, cadres, attributs d'événement et adresses exécutant du code sont retirés. Le nombre d'éléments retirés figure dans la ligne de résultat.

Les tableaux sont-ils convertis eux aussi ?

Oui. Les tableaux tracés à la barre verticale deviennent de vraies balises de tableau, avec leur ligne d'en-tête et leur ligne d'alignement. Si vos données sont encore dans un fichier CSV, passer d'abord par l'outil CSV vers tableau Markdown vous fait gagner une étape.

Les listes imbriquées sont-elles préservées ?

Oui. Tant que vous indentez les sous-éléments, la profondeur ressort telle quelle ; deux ou quatre espaces d'indentation suffisent. Les éléments d'une liste de tâches ressortent en case cochée ou vide.

Les caractères d'un bloc de code peuvent-ils s'abîmer ?

Non. Aucune mise en forme n'est appliquée dans un bloc de code ni dans le code en ligne, et les chevrons deviennent du texte à l'intérieur de la balise de code : ils s'affichent donc tels que vous les avez tapés. Un nom de langage écrit après la clôture d'ouverture ajoute la classe de ce langage à la balise de sortie.

Mon texte est-il envoyé quelque part ?

Non. La conversion et le filtre de sécurité sont assurés par deux bibliothèques qui tournent dans votre navigateur ; le texte collé n'atteint aucun serveur.