Convertisseur en ligne gratuit de ASCIIDOC en ORG

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage en texte brut destiné à la documentation technique, aux manuels, aux fichiers README, aux livres et aux sites web. Les fichiers utilisent généralement les extensions .adoc ou .asciidoc et sont créés avec Asciidoctor, le processeur AsciiDoc d’origine, des systèmes de documentation tels qu’Antora ou n’importe quel éditeur de texte.

AsciiDoc prend en charge les titres hiérarchiques, les attributs, les références croisées, les tableaux, les avertissements, les listes de code source, les images, les inclusions, les conditionnelles et les extensions de blocs. Sa syntaxe est plus expressive que celle d’un balisage léger de base, mais plusieurs de ces fonctionnalités n’ont pas d’équivalent direct dans Org.

Qu’est-ce que le format ORG ?

Org est un format de balisage en texte brut associé au mode Org d’Emacs. Les fichiers Org utilisent l’extension .org et combinent des titres structurés avec des états TODO, des balises, des propriétés, des tableaux, des blocs source, des liens, des citations, la planification et des données d’agenda.

Org est utile lorsque le document converti doit être modifié dans Emacs, interrogé avec l’agenda Org ou des outils de recherche, exporté en HTML ou en PDF, ou conservé dans le cadre d’un projet de programmation lettrée. Sa syntaxe de titres utilise des astérisques, les blocs source utilisent #+BEGIN_SRC et #+END_SRC, et les liens utilisent la notation entre crochets propre à Org.

Comment convertir concrètement ASCIIDOC en ORG

Le workflow de bureau le plus fiable utilise Asciidoctor, puis Pandoc. Asciidoctor résout la syntaxe et les inclusions AsciiDoc, tandis que Pandoc convertit la structure DocBook obtenue en Org.

1. Installez Asciidoctor et Pandoc à l’aide des packages adaptés à votre système d’exploitation.
2. Depuis le répertoire contenant le fichier source, générez du DocBook et transmettez-le à Pandoc :

asciidoctor -b docbook5 -o - input.adoc | pandoc -f docbook -t org -o output.org

La commande lit input.adoc, écrit la sortie DocBook d’Asciidoctor sur la sortie standard et enregistre le résultat Org sous output.org. Remplacez les noms de fichiers si nécessaire ; utilisez le même répertoire de travail lorsque le document contient des chemins relatifs vers des images ou des inclusions.

Pour un workflow en plusieurs étapes, enregistrez le fichier intermédiaire afin de pouvoir l’inspecter :

asciidoctor -b docbook5 -o intermediate.xml input.adoc
pandoc -f docbook -t org intermediate.xml -o output.org

Ouvrez output.org dans Emacs et vérifiez les niveaux de titre, les liens, les noms des langages source, les tableaux, les chemins des images ainsi que les éventuelles métadonnées Org à ajouter manuellement. Pour une conversion sans installation, utilisez le convertisseur gratuit de 101convert.com et téléchargez le fichier .org obtenu.

Limites en matière de qualité et de compatibilité

Le contenu structurel est généralement bien converti, mais les attributs AsciiDoc, les sections conditionnelles, les rôles personnalisés, les blocs passthrough, les extensions de diagrammes et les macros spécifiques au processeur peuvent être omis ou réduits à du texte ordinaire. Asciidoctor développe les inclusions standard lors de la première commande, mais les fichiers inclus doivent être disponibles et référencés avec des chemins relatifs utilisables.

Les avertissements et les blocs stylisés AsciiDoc peuvent ne pas correspondre à des constructions Org natives ; vérifiez-les après la conversion. Les tableaux peuvent nécessiter un alignement ou une réécriture manuelle, et les références aux images restent dépendantes des fichiers de ressources d’origine. DocBook est une représentation intermédiaire : le style AsciiDoc et le comportement spécifique au backend ne sont donc pas conservés exactement.

Si la source utilise des extensions Asciidoctor personnalisées, convertissez d’abord un échantillon représentatif et comparez le fichier Org généré avec l’original avant de traiter un ensemble de documents plus important.