Convertisseur en ligne gratuit de ASCIIDOC en DOCX

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage en texte brut destiné aux documents structurés tels que les manuels de logiciels, les notes de version, les livres, les spécifications et les fichiers README. Les fichiers utilisent généralement les extensions .adoc ou .asciidoc et peuvent être créés avec n’importe quel éditeur de texte, un IDE ou des systèmes de documentation basés sur Asciidoctor.

AsciiDoc stocke les titres, les listes, les tableaux, les liens, les blocs de code source, les images, les avertissements, les attributs et les références croisées sous forme de texte lisible. Asciidoctor est le convertisseur le plus utilisé et peut générer du HTML, du DocBook, des fichiers PDF à l’aide d’outils supplémentaires ainsi que d’autres formats de sortie.

Qu’est-ce que le format DOCX ?

DOCX est le format de document basé sur XML utilisé par Microsoft Word et pris en charge par LibreOffice Writer, OnlyOffice et d’autres applications bureautiques. Il convient aux flux de travail de traitement de texte nécessitant des paragraphes modifiables, des styles, des tableaux, des commentaires, le suivi des modifications, des en-têtes, des pieds de page et une impression orientée page.

DOCX est préférable lorsque les destinataires doivent réviser visuellement le document, appliquer des modèles Word, ajouter des commentaires de révision ou envoyer un fichier à un système qui n’accepte pas le balisage en texte brut. Contrairement à AsciiDoc, DOCX ne conserve pas le balisage source comme interface principale de modification.

Comment convertir réellement ASCIIDOC en DOCX

Utiliser Asciidoctor et Pandoc

La méthode de bureau la plus contrôlable consiste à générer un fichier DocBook à partir d’AsciiDoc avec Asciidoctor, puis à convertir le fichier DocBook en DOCX avec Pandoc.

1. Installez Asciidoctor et Pandoc. Lorsque Ruby est installé, Asciidoctor peut être installé à l’aide de gem install asciidoctor. Installez Pandoc à partir de son package de bureau officiel pour votre système d’exploitation.
2. Ouvrez un terminal dans le répertoire contenant le fichier source et générez un fichier DocBook 5 :

asciidoctor -b docbook5 -o manual.xml manual.adoc

3. Convertissez le fichier intermédiaire en DOCX :

pandoc manual.xml -o manual.docx

4. Ouvrez manual.docx dans Word ou LibreOffice Writer et vérifiez les titres, les tableaux, les images, les blocs de code, les sauts de page et les liens avant de le distribuer.

Pour utiliser un modèle Word, fournissez un DOCX de référence contenant les styles souhaités :

pandoc manual.xml --reference-doc=company-template.docx -o manual.docx

Conservez les images aux chemins relatifs utilisés par la source AsciiDoc. Si la source utilise des attributs ou des inclusions, exécutez Asciidoctor depuis le répertoire du projet afin que ces fichiers puissent être résolus. Un document composé de plusieurs fichiers source peut d’abord être assemblé avec une directive include::, puis traité à l’aide des mêmes commandes.

Utiliser le convertisseur en ligne

Vous pouvez convertir gratuitement le fichier sur 101convert.com sans installer de logiciel : téléversez le fichier ASCIIDOC, choisissez DOCX comme format de sortie, lancez la conversion, puis téléchargez le document généré. Vérifiez le résultat après le téléchargement, en particulier si la source contient des images locales, des inclusions, des extensions Asciidoctor personnalisées ou des diagrammes.

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

L’étape intermédiaire DocBook préserve mieux la structure standard du document que le fait de copier du HTML généré dans Word, mais elle ne peut pas reproduire toutes les fonctionnalités d’Asciidoctor. Les extensions personnalisées, les blocs passthrough, le contenu conditionnel, la logique complexe des attributs, les processeurs de diagrammes, la mise en forme spécialisée des avertissements et certaines macros peuvent être omis ou convertis en texte ordinaire.

DOCX utilise la mise en page et les styles Word, tandis qu’AsciiDoc décrit principalement une structure sémantique. Prévoyez d’ajuster les marges, les polices, la largeur des tableaux, la coloration syntaxique, la taille des images, les légendes, les en-têtes, les pieds de page et les sauts de page dans le DOCX obtenu. Les blocs de code source et les tableaux méritent une attention particulière, car les lignes longues et les colonnes larges peuvent dépasser des limites de la page.

Les liens et les titres de base sont généralement bien convertis. Les références croisées, les notes de bas de page, les médias intégrés et les chemins relatifs des images dépendent des versions d’Asciidoctor et de Pandoc ainsi que de l’organisation de la source. Conservez le fichier .adoc d’origine comme source de référence si le document doit continuer à être géré.