Convertidor online gratuito de ASCIIDOC a DOCX

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado de texto plano para documentos estructurados, como manuales de software, notas de versión, libros, especificaciones y archivos README. Los archivos suelen utilizar las extensiones .adoc o .asciidoc y pueden crearse con cualquier editor de texto, un IDE o sistemas de documentación basados en Asciidoctor.

AsciiDoc almacena encabezados, listas, tablas, enlaces, bloques de código fuente, imágenes, advertencias, atributos y referencias cruzadas como texto legible. Asciidoctor es el conversor más utilizado y puede generar HTML, DocBook, PDF mediante herramientas adicionales y otros formatos de salida.

Qué es el formato DOCX

DOCX es el formato de documento basado en XML utilizado por Microsoft Word y compatible con LibreOffice Writer, OnlyOffice y otras aplicaciones de oficina. Es adecuado para flujos de trabajo de procesamiento de textos que requieren párrafos editables, estilos, tablas, comentarios, control de cambios, encabezados, pies de página e impresión orientada a páginas.

DOCX es preferible cuando los destinatarios necesitan revisar visualmente el documento, aplicar plantillas de Word, añadir comentarios de revisión o enviar un archivo a un sistema que no acepta marcado de texto plano. A diferencia de AsciiDoc, DOCX no conserva el marcado de origen como interfaz principal de edición.

Cómo convertir realmente ASCIIDOC a DOCX

Uso de Asciidoctor y Pandoc

El método de escritorio más controlable consiste en generar AsciiDoc como DocBook con Asciidoctor y convertir después el archivo DocBook a DOCX con Pandoc.

1. Instala Asciidoctor y Pandoc. Con Ruby instalado, Asciidoctor puede instalarse mediante gem install asciidoctor. Instala Pandoc desde su paquete de escritorio oficial para tu sistema operativo.
2. Abre una terminal en el directorio que contiene el archivo de origen y genera DocBook 5:

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

3. Convierte el archivo intermedio a DOCX:

pandoc manual.xml -o manual.docx

4. Abre manual.docx en Word o LibreOffice Writer y comprueba los encabezados, las tablas, las imágenes, los bloques de código, los saltos de página y los enlaces antes de distribuirlo.

Para utilizar una plantilla de Word, proporciona un DOCX de referencia que contenga los estilos deseados:

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

Mantén las imágenes disponibles en las rutas relativas utilizadas por el origen AsciiDoc. Si el origen utiliza atributos o inclusiones, ejecuta Asciidoctor desde el directorio del proyecto para que esos archivos puedan resolverse. Un documento con varios archivos de origen puede ensamblarse primero con una directiva include:: y procesarse después mediante los mismos comandos.

Uso del conversor en línea

Puedes convertir el archivo gratuitamente en 101convert.com sin instalar software: carga el archivo ASCIIDOC, elige DOCX como formato de salida, inicia la conversión y descarga el documento generado. Revisa el resultado después de descargarlo, especialmente si el origen contiene imágenes locales, inclusiones, extensiones personalizadas de Asciidoctor o diagramas.

Limitaciones de calidad y compatibilidad

El paso intermedio por DocBook conserva la estructura estándar del documento mejor que copiar HTML renderizado en Word, pero no puede reproducir todas las funciones de Asciidoctor. Las extensiones personalizadas, los bloques passthrough, el contenido condicional, la lógica compleja de atributos, los procesadores de diagramas, los estilos especializados de advertencias y algunas macros pueden omitirse o convertirse en texto normal.

DOCX utiliza el diseño de página y los estilos de Word, mientras que AsciiDoc describe principalmente la estructura semántica. Espera tener que ajustar los márgenes, las fuentes, los anchos de las tablas, el resaltado de sintaxis, los tamaños de las imágenes, los pies de imagen, los encabezados, los pies de página y los saltos de página en el DOCX resultante. Los bloques de código fuente y las tablas merecen una revisión especial porque las líneas largas y las columnas anchas pueden desbordar la página.

Los enlaces y los encabezados básicos suelen convertirse correctamente. Las referencias cruzadas, las notas al pie, los medios incrustados y las rutas relativas de las imágenes dependen de las versiones de Asciidoctor y Pandoc y de cómo esté organizado el origen. Conserva el archivo .adoc original como fuente autorizada si el documento seguirá manteniéndose.