Publication Markdown vers HTML : Guide sur la couverture de syntaxe GFM et le style en ligne

GFM est la spécification d'extension Markdown définie par GitHub, qui inclut quatre types courants d'extensions au-delà de la syntaxe de base. Le convertisseur Markdown vers HTML d'OKfmt prend en charge la conversion complète de format pour tous les quatre types d'extensions, et génère des balises HTML correspondant à la sémantique standard.

Les quatre types d'extensions sont les tableaux avec attributs d'alignement, le texte barré, les listes de tâches et les blocs de code délimités. Après conversion, la structure et les informations de style de la syntaxe d'origine sont conservées, ce qui répond aux exigences d'affichage de la plupart des plateformes de publication de contenu publiques.

Le convertisseur Markdown vers HTML d'OKfmt génère par défaut un document HTML5 complet avec une déclaration DOCTYPE, et tous les styles de typographie sont écrits dans les balises correspondantes sous forme de CSS en ligne. Le résultat de la conversion peut s'afficher normalement sans dépendre de feuilles de style externes.

Cette sortie est adaptée aux scénarios de publication qui ne prennent pas en charge les styles externes, tels que les corps de courriels internes d'entreprise, les systèmes de gestion de contenu qui n'autorisent pas de CSS personnalisé, et les zones d'édition de texte enrichi des plateformes de blogs tierces. Les utilisateurs peuvent copier le code HTML converti et le coller directement pour publication.

Certains éditeurs Markdown permettent aux utilisateurs d'incorporer des balises HTML brutes dans le contenu. Ces balises peuvent contenir du code script malveillant, ce qui entraîne des risques de sécurité pour les pages publiées. OKfmt adopte un mécanisme de protection qui ne restitue pas les balises HTML brutes d'entrée.

L'outil convertit par échappement les balises HTML brutes du contenu d'entrée en sortie de texte brut, empêchant l'exécution des balises dans le document HTML converti, évitant les attaques d'injection de script intersite XSS, et garantit la sécurité d'accès des pages publiées.

Le convertisseur Markdown vers HTML d'OKfmt effectue uniquement une conversion de format, et ne traite pas le transfert ou le stockage des ressources d'image. Pendant la conversion, les adresses de lien d'image du contenu Markdown d'origine sont conservées et écrites directement dans l'attribut src de la balise img du HTML généré.

Les utilisateurs doivent télécharger eux-mêmes les images d'origine vers l'hébergement d'images ou le serveur de stockage de la plateforme cible, puis remplacer les adresses de lien correspondantes. L'outil lui-même ne stocke aucun contenu téléchargé par les utilisateurs, et toutes les opérations de conversion sont effectuées dans le navigateur local de l'utilisateur.

OKfmt propose également un service de conversion inverse de format HTML vers Markdown. Le scénario d'application principal de ce service est l'archivage Markdown de contenu web public. Les utilisateurs peuvent copier le contenu HTML du texte d'une page web pour le convertir en texte Markdown structuré en vue de son stockage.

Le processus de conversion conserve la structure du contenu d'origine, y compris les niveaux de titre, les listes, les liens et les images, et supprime le code redondant tel que la navigation et les publicités propres à la page web. Le Markdown converti peut être utilisé pour l'archivage personnel de notes de connaissances, ou republicé après une édition secondaire.