Convertisseur en ligne gratuit de ASCIIDOC en TYP

Typst nécessite des documents source dans son format de balisage .typ, tandis que de nombreux projets de documentation sont rédigés sous forme de fichiers .adoc ou .asciidoc. Les convertir permet de réutiliser une documentation structurée dans un workflow de publication Typst sans recréer manuellement chaque titre, liste et référence.

Présentation du format ASCIIDOC

AsciiDoc est un format de balisage en texte brut destiné à la documentation technique, aux manuels, aux fichiers README, aux livres et aux pages web. Les fichiers utilisent couramment les extensions .adoc ou .asciidoc ; Asciidoctor et Asciidoctor.js permettent de les créer et de les traiter. Le format prend en charge les titres, les listes, les tableaux, les blocs de code source, les références croisées, les attributs, les inclusions, les avertissements, les images et les métadonnées de document.

Présentation du format TYP

Dans la catégorie des fichiers texte, .typ désigne le balisage source Typst. Typst est un système de composition dont le compilateur transforme les fichiers source en PDF et en d’autres sorties rendues. Les fichiers TYP combinent une syntaxe source lisible avec des instructions de mise en page pour les titres, les figures, les tableaux, les citations, les paramètres de page et les fonctions réutilisables. Ils sont utiles lorsque le workflow de destination utilise le compilateur Typst plutôt qu’un moteur de rendu AsciiDoc ou une toolchain LaTeX.

Comment convertir réellement ASCIIDOC en TYP

La méthode automatisée la plus fiable consiste à utiliser Asciidoctor pour produire du DocBook XML, puis Pandoc pour générer du Typst. Installez Asciidoctor et une version récente de Pandoc, puis exécutez :

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Remplacez document.adoc par le nom du fichier source. La première commande développe la structure AsciiDoc en DocBook ; la seconde convertit les éléments DocBook en balisage Typst. Compilez le résultat avec :

typst compile document.typ

Pour un fichier AsciiDoc qui dépend d’attributs, définissez-les lors de la conversion, par exemple :

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

Vous pouvez également utiliser le convertisseur gratuit de 101convert.com sans installer de logiciel : sélectionnez le format source ASCIIDOC, importez le fichier, choisissez TYP, puis enregistrez le résultat converti.

Limites de qualité et de compatibilité

Il s’agit d’une traduction de balisage, et non d’une modification du format au niveau binaire. Les titres, paragraphes, mises en évidence, listes, tableaux, blocs de code et nombreux liens simples sont généralement bien transférés, mais les attributs AsciiDoc, le contenu conditionnel, les rôles personnalisés, les macros, les extensions, les inclusions et les blocs de diagrammes peuvent nécessiter une réécriture manuelle en Typst.

Résolvez les inclusions et générez les ressources externes avant la conversion lorsque cela est possible. Vérifiez les chemins des images, les largeurs des tableaux, les citations, les paramètres de page et les références croisées dans le fichier .typ généré. Pandoc peut préserver le contenu tout en modifiant la sémantique de la mise en page ; compilez donc le fichier avec Typst et inspectez le PDF rendu plutôt que de vous fier uniquement au code source converti.