Markdown en HTML — Source et aperçu

Convertir un brouillon et exporter sa source

1. Collez ou saisissez du Markdown, ou importez un fichier Markdown ou texte en UTF-8. CRLF et CR deviennent LF ; le contenu n’est ni rogné ni normalisé en Unicode. Un fichier importé attend que vous lanciez Convertir et toute modification du brouillon supprime le résultat précédent.
2. Appuyez sur Convertir pour analyser et vérifier le profil pris en charge. Le HTML brut reste du texte et les destinations interdites de liens ou d’images arrêtent la conversion au lieu d’être supprimées silencieusement. Utilisez Source pour examiner le HTML complet ou Aperçu pour voir la mise en forme inerte lorsque ses limites propres le permettent.
3. Copiez la source ou téléchargez converted.html. Les deux utilisent exactement le même fragment UTF-8, sans conteneur de page, CSS ni marque d’ordre des octets ajoutés. L’aperçu n’est pas exporté et le HTML téléchargé ne s’ouvre pas automatiquement.

Comprendre le format et l’aperçu

Le profil est celui par défaut de markdown-it 15.0.3 avec tableaux et texte barré, ainsi que les restrictions explicites de l’outil sur l’entrée, l’imbrication et les URL. Il prend en charge les titres, listes, citations, mises en emphase et codes échappés courants, mais ne couvre pas tout GitHub-flavored Markdown. Aucun module de listes de tâches, mathématiques, diagrammes, notes de bas de page ou coloration syntaxique n’est ajouté.

Le HTML brut est rendu comme du texte et non activé. Par exemple, une balise script du brouillon n’est pas un script exécuté dans l’aperçu. Ce comportement n’est pas un assainisseur général de HTML arbitraire et un Markdown mal formé peut rester du texte ordinaire au lieu de provoquer une erreur de syntaxe.

Les liens et références d’images autorisés restent dans le fragment source. Dans l’aperçu, les liens sont des éléments span non interactifs et les images des substituts étiquetés ; aucune ressource n’y est récupérée. Un aperçu volumineux peut être entièrement omis tandis que la source complète, la copie et le téléchargement restent disponibles. L’aperçu ne reproduit pas une page hébergée au pixel près.

Les références relatives ne sont résolues ni par rapport à ce site ni par rapport à l’emplacement du fichier importé. Votre page de publication détermine leur base finale. L’ouverture ou le réhébergement d’un fragment exporté peut donc charger ses images autorisées ou suivre ses liens, contrairement à l’aperçu inerte de cet outil.

Exemples de structure, de références et de sortie vide

Utiliser l’exemple insère un titre A, une ligne vide et Hello avec world en gras, sans lancer automatiquement la conversion. Celle-ci doit produire un titre h1 et un paragraphe contenant une emphase strong. Les détails du résultat expliquent le profil actif, le nombre d’octets et le comportement distinct de l’aperçu.

Un lien relatif comme ../guide?q=x#part peut rester une référence HTML relative. Une image HTTPS peut rester dans la source mais n’apparaît dans l’aperçu que sous forme de substitut avec texte alternatif. Une adresse mailto est permise pour un lien, pas pour une image ; les images data, les schémas de script et les références relatives au protocole sont refusés.

Un document non vide contenant uniquement des définitions de références inutilisées peut légitimement produire un fragment HTML de zéro octet. Ce n’est pas la même chose qu’une entrée vide et incomplète. Le résultat explique cette sortie vide et permet de copier ou télécharger exactement ces zéro octet sans inventer de paragraphe.

Limites explicites de syntaxe, de ressources et d’export

Le brouillon reçu accepte jusqu’à 200000 unités UTF-16 ; le UTF-8 canonique et tout fichier importé sont limités à 512 KiB, avec au plus 20000 lignes. NUL, le UTF-8 mal formé et les substituts non appariés sont refusés. Exactement un BOM UTF-8 initial du fichier est supprimé ; un U+FEFF ultérieur est conservé. Les modifications trop volumineuses sont refusées plutôt que partiellement tronquées.

Des garde-fous d’imbrication, 100000 jetons analysés, des chaînes de destination et de délimitation bornées, un plafond de 4 MiB pour la source produite et un délai d’opération de 15 secondes limitent le traitement. L’aperçu est en outre limité à 256 KiB, 20000 jetons et 10000 éléments générés. Ce sont des contrôles du produit, pas des garanties de vitesse, de mémoire de tas ou d’appareil ; une conversion échouée ne produit aucun résultat partiel réussi.

Les liens suivent le profil explicite HTTP(S), mailto et références relatives ; les images nécessitent un chemin HTTP(S) ou relatif. Les schémas non pris en charge, identifiants, autorités ambiguës et encodages interdits de caractères de contrôle ou de barres obliques inverses arrêtent la conversion. Une destination autorisée ne garantit pas la fiabilité du site lié ni du fragment téléchargé.

Il n’y a ni export de page complète, CSS utilisateur, mode HTML brut, éditeur en direct, import depuis le cloud ou une URL, persistance, ni conversion par lots. Copier et Télécharger utilisent toujours le fragment actuel enregistré, pas l’aperçu. Modifier l’entrée ou annuler invalide les anciennes actions ; une copie dans le presse-papiers ou un téléchargement déjà transmis au système d’exploitation ne peut pas être retiré.

Traitement local du brouillon et résultats actuels

L’analyse et le rendu s’exécutent dans un worker local. Cet outil n’ajoute aucun envoi de brouillon ou de fichier, récupération d’URL, adresse contenant l’entrée, historique enregistré ou télémétrie du contenu. Son aperçu isolé ne charge pas les images et n’active pas les liens. Les services existants du site restent en place ; le traitement local ne certifie ni les fournisseurs d’analyse ni le comportement déployé.