Convertisseur en ligne gratuit de DOCX en ADOC

Les documents Word sont convertis en AsciiDoc lorsque la documentation doit être conservée dans Git, révisée sous forme de texte ou rendue par un système de publication AsciiDoc. Le fichier source .adoc ainsi obtenu est plus facile à comparer, fusionner et réutiliser dans des compilations HTML ou PDF qu’un fichier Word.

Format DOCX

.docx est le format Microsoft Word par défaut et fait partie d’Office Open XML. Un fichier DOCX est un package ZIP contenant du XML et des fichiers associés pour le texte, les styles, les tableaux, les images, les commentaires, les révisions, les en-têtes, les pieds de page et les propriétés du document.

Microsoft Word est son éditeur principal ; LibreOffice Writer, Google Docs, Apple Pages et de nombreux systèmes de gestion documentaire peuvent également ouvrir ou exporter des fichiers DOCX. Le format préserve bien la mise en page et le formatage des documents bureautiques, mais sa structure empaquetée est peu adaptée à la révision ligne par ligne dans un système de contrôle de version.

Format ADOC

.adoc identifie généralement un fichier source AsciiDoc. AsciiDoc est du texte brut UTF-8 avec un balisage pour les titres de section, les listes, les tableaux, les liens, les blocs de code, les admonitions, les attributs et les références d’image. Les autres extensions courantes d’AsciiDoc sont .asciidoc et .ad.

Des processeurs tels qu’Asciidoctor peuvent générer du HTML, du PDF, du DocBook, de l’EPUB ou du contenu pour un site de documentation à partir d’AsciiDoc. Les images sont normalement des fichiers séparés référencés par la source, ce qui conserve la lisibilité du texte et facilite la gestion des ressources d’image dans Git.

Confirmez le format requis avant la conversion. Quelques produits utilisent .adoc pour des fichiers propriétaires sans rapport ; cette conversion produit du texte AsciiDoc, et non ces formats.

Convertir le fichier

Pour convertir le fichier sans installer de logiciel, téléversez le fichier DOCX vers le convertisseur de 101convert.com, sélectionnez ADOC comme format de sortie, lancez la conversion, puis téléchargez le fichier .adoc généré. Ouvrez-le dans un éditeur de texte et vérifiez les titres, les tableaux, les liens et les références d’image avant de l’utiliser dans un flux de publication.

Pour une conversion locale reproductible, Pandoc lit les fichiers DOCX et écrit de l’AsciiDoc. Après avoir installé Pandoc, exécutez cette commande depuis le dossier contenant le document :

pandoc input.docx --from=docx --to=asciidoc --extract-media=media --wrap=none --output=output.adoc

--extract-media=media écrit les images intégrées dans un répertoire media et génère des références d’image dans la sortie. Conservez ce répertoire avec le fichier ADOC lors du déplacement ou de la publication du document. --wrap=none évite les retours à la ligne arbitraires, ce qui peut produire des différences plus propres dans le contrôle de version.

Effectuez le rendu du résultat avec Asciidoctor pour vérifier le balisage généré :

asciidoctor output.adoc

Cela crée output.html, qui peut être ouvert dans un navigateur pour vérification.

Limites de la conversion

La conversion dépend de la sémantique du document plutôt que de son apparence visuelle. Appliquez les styles de titre intégrés de Word avant la conversion ; un texte agrandi ou mis en gras sans style de titre peut rester un paragraphe normal.

Les paragraphes simples, les styles de titre, les listes, les mises en valeur élémentaires, les liens et les tableaux simples sont généralement transférés de manière acceptable. Les tableaux fusionnés ou imbriqués, les largeurs de colonne fixes, la trame de fond des cellules, les zones de texte, les objets flottants, SmartArt, les équations, les mises en page complexes et les images positionnées n’ont pas d’équivalent direct en AsciiDoc et nécessitent une réécriture manuelle ou un remplacement par des images et un balisage standard.

Résolvez les modifications suivies avant la conversion et conservez séparément les commentaires nécessaires. Les en-têtes, les pieds de page, les champs de numérotation des pages, les macros, la protection des documents et les contrôles de mise en page propres à Word ne constituent pas un contenu AsciiDoc fiable ; déplacez les informations essentielles dans des sections ordinaires du document.

Les hyperliens externes sont généralement convertis correctement, mais les signets Word et les références croisées doivent être testés après le rendu. Pour des liens internes durables, attribuez des ancres AsciiDoc explicites telles que [[installation]] et référencez-les avec <<installation,Installation>>.