Convertidor online gratuito de DOCX a ADOC

Los documentos de Word se convierten a AsciiDoc cuando la documentación debe mantenerse en Git, revisarse como texto o renderizarse mediante un sistema de publicación de AsciiDoc. El código fuente .adoc resultante es más fácil de comparar, combinar y reutilizar en compilaciones de HTML o PDF que un archivo de Word.

Formato DOCX

.docx es el formato predeterminado de Microsoft Word y forma parte de Office Open XML. Un archivo DOCX es un paquete ZIP que contiene XML y archivos relacionados para texto, estilos, tablas, imágenes, comentarios, revisiones, encabezados, pies de página y propiedades del documento.

Microsoft Word es su editor principal; LibreOffice Writer, Google Docs, Apple Pages y muchos sistemas de gestión documental también pueden abrir o exportar DOCX. El formato conserva bien la disposición y el formato de los documentos de oficina, pero su estructura empaquetada no es adecuada para la revisión línea por línea en sistemas de control de versiones.

Formato ADOC

.adoc normalmente identifica un archivo de código fuente de AsciiDoc. AsciiDoc es texto sin formato UTF-8 con marcado para títulos de sección, listas, tablas, enlaces, bloques de código, advertencias, atributos y referencias a imágenes. Otras extensiones comunes de AsciiDoc son .asciidoc y .ad.

Procesadores como Asciidoctor pueden renderizar AsciiDoc como HTML, PDF, DocBook, EPUB o contenido para sitios de documentación. Normalmente, las imágenes son archivos independientes referenciados por el código fuente, lo que mantiene el texto legible y facilita la gestión de los recursos de imagen en Git.

Confirma el formato requerido antes de realizar la conversión. Algunos productos usan .adoc para archivos propietarios no relacionados; esta conversión produce texto AsciiDoc, no esos formatos.

Convertir el archivo

Para convertirlo sin instalar software, carga el archivo DOCX en el conversor de 101convert.com, selecciona ADOC como formato de salida, inicia la conversión y descarga el archivo .adoc generado. Ábrelo en un editor de texto y revisa los títulos, las tablas, los enlaces y las referencias a imágenes antes de utilizarlo en un flujo de publicación.

Para realizar conversiones locales repetibles, Pandoc lee DOCX y escribe AsciiDoc. Después de instalar Pandoc, ejecuta este comando desde la carpeta que contiene el documento:

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

--extract-media=media escribe las imágenes incrustadas en un directorio media y genera referencias a imágenes en la salida. Conserva ese directorio junto con el archivo ADOC al mover o publicar el documento. --wrap=none evita el ajuste de línea arbitrario, lo que puede generar diferencias más limpias en el control de código fuente.

Renderiza el resultado con Asciidoctor para comprobar el marcado generado:

asciidoctor output.adoc

Esto crea output.html, que se puede abrir en un navegador para revisarlo.

Limitaciones de la conversión

La conversión depende de la semántica del documento y no de su apariencia visual. Aplica los estilos integrados de Título de Word antes de la conversión; el texto al que solo se haya aplicado un tamaño mayor o negrita sin un estilo de título puede permanecer como un párrafo normal.

Los párrafos simples, los estilos de título, las listas, el énfasis básico, los enlaces y las tablas sencillas normalmente se transfieren de forma aceptable. Las tablas combinadas o anidadas, los anchos de columna fijos, el sombreado de celdas, los cuadros de texto, los objetos flotantes, SmartArt, las ecuaciones, la disposición compleja de página y las imágenes posicionadas no tienen un equivalente directo en AsciiDoc y requieren una reescritura manual o su sustitución por imágenes y marcado estándar.

Resuelve los cambios controlados antes de la conversión y conserva por separado los comentarios necesarios. Los encabezados, pies de página, campos de número de página, macros, la protección del documento y los controles de disposición específicos de Word no son contenido fiable de AsciiDoc; traslada la información esencial a secciones normales del documento.

Los hipervínculos externos normalmente se convierten correctamente, pero los marcadores de Word y las referencias cruzadas deben probarse después del renderizado. Para obtener enlaces internos duraderos, asigna anclas explícitas de AsciiDoc como [[installation]] y haz referencia a ellas con <<installation,Installation>>.