Deux écritures pour un document
Markdown indique les titres, l’emphase, les listes et les liens avec une ponctuation légère. HTML nomme ces structures par des éléments tels que h2, strong, ul et a. Un moteur interprète Markdown avant de produire du HTML ; il ne remplace pas chaque astérisque ou dièse mécaniquement. Le contexte décide si un dièse commence un titre ou appartient au texte. HTML accepte aussi des attributs, des éléments imbriqués et des règles d’analyse que le raccourci Markdown ne peut pas toujours reproduire.
Choisissez Markdown lorsque la source doit rester facile à modifier en texte brut. Choisissez HTML lorsque la destination attend des éléments explicites ou que vous voulez contrôler ce que reçoit le navigateur. Déterminez d’abord la variante de Markdown admise. MultiVerto traite un sous-ensemble documenté : titres, paragraphes, listes simples, emphase, liens et code en ligne dans les deux sens. Les blocs de code délimités ne passent que vers HTML. Certaines constructions sont refusées ; d’autres s’affichent comme du texte littéral.
Un exemple dans les deux sens
Saisissez deux dièses suivis de Notes, une ligne vide, puis la phrase Un brouillon **prêt**. Le convertisseur crée un élément h2 contenant Notes et un paragraphe où strong entoure prêt. Le navigateur affiche le titre et le mot en gras ; le code HTML garde les frontières des éléments. L’exemple interactif contient aussi un lien : son adresse se trouve dans l’attribut href plutôt que dans la phrase affichée.
Passez ensuite ce HTML admis dans le convertisseur inverse. Il peut représenter h2 par un titre Markdown, strong par deux astérisques et le lien par un libellé entre crochets suivi de l’URL. L’affichage peut rester équivalent même si les espaces, retours à la ligne ou caractères exacts de la source changent. Comparez la structure visible et la cible du lien, pas uniquement l’identité octet pour octet du Markdown initial.
- Markdown : ## Notes et **prêt**
- HTML : éléments h2 et strong
- Retour Markdown : vérifier titre, emphase et lien
Pourquoi le retour peut perdre des détails
HTML possède des structures et des attributs sans raccourci Markdown simple. Un span stylé, un tableau, un attribut personnalisé ou des listes imbriquées ne passent pas forcément dans le sens inverse ; cet outil local rejette beaucoup de ces cas. À l’inverse, les moteurs Markdown ne gèrent pas tous les tableaux, tâches, citations ou fragments HTML de la même façon. MultiVerto refuse plusieurs de ces syntaxes plutôt que de fabriquer une sortie silencieuse. Réussir un petit essai ne valide donc pas un document complexe.
Même les structures acceptées ont plusieurs orthographes. Un élément strong et un élément b peuvent tous deux revenir sous forme d’astérisques : le choix de la balise d’origine disparaît. Le navigateur peut également corriger un HTML mal formé. Avant publication, examinez le balisage produit et affichez-le dans l’environnement visé. Gardez le fichier original pour retrouver les attributs, commentaires ou décisions de mise en page que le format simplifié ne sait pas conserver.
Échapper le texte est une autre tâche
Encoder un caractère HTML pour l’afficher n’est pas produire une structure HTML à partir de Markdown. Pour montrer littéralement <h2>Notes</h2>, représentez les chevrons par des entités ou placez le fragment dans un contexte de code fiable. Pour créer un titre, utilisez le véritable élément h2. L’encodeur d’entités lié ci-dessous change la représentation du texte ; le convertisseur Markdown crée des éléments. Considérez les contenus fournis par autrui comme non fiables dans les deux parcours.
Le convertisseur local échappe le texte ordinaire de son sous-ensemble reconnu. Une publication qui accepte des contributions arbitraires doit néanmoins employer un analyseur entretenu et une désinfection adaptée lorsque des liens ou balises peuvent apparaître. Vérifiez les URL et éléments autorisés par la destination. Convertissez un petit exemple, contrôlez le HTML, affichez-le, puis revenez uniquement sur la partie prise en charge. Si une propriété disparaît, conservez le format le plus riche comme source de référence.