Le TXT est du texte brut, sans balisage d'aucune sorte. Le HTML est le balisage du web, avec des titres et des tableaux natifs. pandoc se tient entre les deux, et cette page dit exactement ce qui arrive à un fichier TXT en route vers le HTML.
Ce qui s'exécute quand un fichier TXT devient un HTML
pandoc en deux passes, sur une machine que nous louons et que nous surveillons. Votre fichier TXT est envoyé une fois, pandoc s'exécute une fois, le fichier HTML revient, et aucun des deux fichiers n'est conservé. TXT vers HTML fait partie des 3649 paires sur lesquelles ce moteur a été sondé avec un vrai fichier, et c'est pour cela que cette page existe quand celles que la sonde n'a pas su prouver n'existent pas.
Ce qui survit du fichier TXT dans le fichier HTML
Les listes du fichier TXT, imbrications comprises, plus les blocs de code, les citations et les liens, tous réexprimés en HTML.
Les images : pandoc les extrait du fichier TXT vers un répertoire de travail et les réintègre dans le HTML, si bien que rien ne finit par pointer vers un fichier qui n'existe plus.
Ce que la conversion TXT vers HTML vous coûte
La couche de présentation. pandoc ne traduit pas le fichier TXT en HTML, il le reconstruit depuis son propre arbre de document : les styles personnalisés, la mise en page, les en-têtes et les pieds de page ne traversent pas. La structure, si, et c'est de cela que l'arbre est fait.
Si un modèle doit lire le fichier HTML
La structure est ce qui subsiste du fichier TXT, et la structure est ce dont un modèle a besoin. TXT en entrée, HTML en sortie, avec l'arbre des titres intact plutôt qu'aplati en un seul long paragraphe.
TXT vers HTML, mesuré plutôt que promis
En passant TXT vers HTML sur le moteur réel avec un vrai fichier, pandoc a écrit 3 896 octets au format HTML en 0,1 secondes, machine par ailleurs au repos. C'est un fichier TXT un jour donné et non une moyenne, et c'est pourquoi le nombre est donné avec le fichier qui l'a produit.
Le verdict TXT vers HTML a été obtenu par un aller-retour pandoc, c'est-à-dire que la sortie a été relue par pandoc et devait encore contenir un mot témoin planté dans la source, ce qui prouve que le contenu a voyagé et pas seulement le conteneur. Le contrôle employé compte, parce qu'ils ne prouvent pas tous la même chose, et un code de statut 200 ne prouve strictement rien sur ce que le fichier HTML contient.
Le même fichier TXT, envoyé ailleurs
Les autres sorties que la sonde a mesurées à partir d'un fichier TXT, pour que le coût du choix du format HTML se lise face à quelque chose. Les tailles ne se comparent pas d'un moteur à l'autre, chaque famille ayant été sondée avec son propre fichier témoin TXT.
TXT vers PDF : 12 976 octets en 1,8 secondes, vérifié par une signature de format.
TXT vers MD : 210 octets en 0,1 secondes, vérifié par un aller-retour pandoc.
TXT vers DOCX : 9 900 octets en 0,1 secondes, vérifié par un aller-retour pandoc.
TXT vers EPUB : 4 955 octets en 0,1 secondes, vérifié par un aller-retour pandoc.
TXT vers RTF : 484 octets en moins d'un dixième de seconde, vérifié par un aller-retour pandoc.
TXT vers ODT : 6 941 octets en 0,1 secondes, vérifié par un aller-retour pandoc.
Les autres routes vers HTML, et ce qu'elles ont mesuré
Parmi les routes publiées vers HTML, TXT est la septième plus grosse sortie des 12 mesurées. Les fichiers témoins diffèrent : ce classement porte sur la sonde et non sur votre document.
DOC vers HTML : 1 626 octets en 1,1 secondes.
XLSX vers HTML : 2 269 octets en 1,1 secondes.
PPTX vers HTML : 14 373 octets en 1,5 secondes.
XLS vers HTML : 2 101 octets en 1,0 secondes.
CSV vers HTML : 3 894 octets en 0,1 secondes.
Ce que nous ne prétendrons pas sur TXT vers HTML
Un fichier TXT de plus de 25 Mo est refusé avant la fin de l'envoi plutôt qu'après, pour que vous n'attendiez pas un refus.
Une conversion TXT vers HTML qui dépasse 60 secondes est tuée, et le processus pandoc avec elle. Une exécution abandonnée resterait posée sur l'un des deux cœurs de la machine jusqu'à ce que quelqu'un le remarque.
32 des 935 paires sondées dans la famille qui sert TXT vers HTML ont échoué, et celle-ci n'en fait pas partie. Elles échouent pour des raisons qu'il vaut mieux connaître : un rédacteur incapable de porter ce dont le document est fait, ou une sortie que le moteur n'a pas su relire. Elles sont comptées ici plutôt que cachées, parce qu'une paire qui échoue en silence est pire qu'une paire qui échoue bruyamment.
pandoc n'écrit jamais le HTML en passant par un moteur TeX ici, et il n'écrit pas de PDF du tout : les onze moteurs qu'il lui faudrait ne sont pas sur cette machine, et une distribution TeX pèse plusieurs gigaoctets. Qui veut un PDF à partir d'un fichier TXT passe par LibreOffice ou par calibre, qui en sont réellement capables.
Un fichier TXT à la fois, choisi dans le navigateur. Il n'y a rien d'autre à régler et rien d'autre à proposer.
TXT vers HTML : les questions que l'on pose
Qu'est-ce qui convertit vraiment mon fichier TXT en HTML ?
C'est pandoc qui s'en charge, en deux passes, sur une machine que nous louons et que nous surveillons. Ni astuce de navigateur, ni service d'un tiers : le fichier TXT est envoyé une fois, pandoc s'exécute une fois, le HTML revient, et aucun des deux fichiers n'est conservé ensuite.
Combien de temps prend une conversion TXT vers HTML ?
Sur le fichier utilisé par la sonde, pandoc a mis 0,1 seconde et écrit 3 896 octets de HTML. C'est une mesure réelle sur un fichier TXT réel, pas une moyenne et pas une promesse sur le vôtre : un TXT plus gros prend plus longtemps, et au-delà de 60 secondes l'exécution est arrêtée.
Qu'est-ce que je perds en passant du TXT au HTML ?
Celle qu'il faut connaître en premier : la couche de présentation. pandoc ne traduit pas le fichier TXT en HTML, il le reconstruit depuis son propre arbre de document : les styles personnalisés, la mise en page, les en-têtes et les pieds de page ne traversent pas. La structure, si, et c'est de cela que l'arbre est fait.
Les tableaux de mon fichier TXT sont-ils encore des tableaux dans le HTML ?
Oui. pandoc lit les tableaux du TXT dans son propre arbre de document et les réécrit en syntaxe HTML, si bien que vous obtenez un tableau qu'une machine sait analyser plutôt qu'une image de tableau.
La conversion TXT vers HTML est-elle gratuite ?
Il y a une franchise gratuite chaque mois, et une conversion TXT vers HTML coûte un demi-crédit dessus. Quand la franchise est épuisée, l'outil le dit et s'arrête, plutôt que de vous remettre discrètement un HTML moins bon.