Convertidor online gratuito de ASCIIDOC a ORG

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado de texto plano para documentación técnica, manuales, archivos README, libros y sitios web. Los archivos suelen usar las extensiones .adoc o .asciidoc y se crean con Asciidoctor, el procesador original de AsciiDoc, sistemas de documentación como Antora o cualquier editor de texto.

AsciiDoc admite encabezados jerárquicos, atributos, referencias cruzadas, tablas, advertencias, listados de código fuente, imágenes, inclusiones, condicionales y extensiones de bloque. Su sintaxis es más expresiva que la de un marcado ligero básico, pero varias de esas funciones no tienen un equivalente directo en Org.

Qué es el formato ORG

Org es un formato de marcado de texto plano asociado con el modo Org de Emacs. Los archivos de Org usan la extensión .org y combinan encabezados estructurados con estados TODO, etiquetas, propiedades, tablas, bloques de código fuente, enlaces, citas, programación y datos de agenda.

Org es útil cuando el documento convertido se editará en Emacs, se consultará con la agenda de Org o herramientas de búsqueda, se exportará a HTML o PDF, o se mantendrá como parte de un proyecto de programación literaria. Su sintaxis de encabezados usa asteriscos, los bloques de código fuente usan #+BEGIN_SRC y #+END_SRC, y los enlaces usan la notación de corchetes propia de Org.

Cómo convertir realmente ASCIIDOC a ORG

El flujo de trabajo de escritorio más fiable es usar Asciidoctor seguido de Pandoc. Asciidoctor resuelve la sintaxis y las inclusiones de AsciiDoc, mientras que Pandoc convierte la estructura DocBook resultante a Org.

1. Instala Asciidoctor y Pandoc usando los paquetes apropiados para tu sistema operativo.
2. Desde el directorio que contiene el archivo de origen, genera DocBook y pásalo a Pandoc:

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

El comando lee input.adoc, escribe la salida DocBook de Asciidoctor en la salida estándar y guarda el resultado de Org como output.org. Sustituye los nombres de archivo según sea necesario; usa el mismo directorio de trabajo cuando el documento contenga rutas relativas de imágenes o inclusiones.

Para un flujo de trabajo de varias etapas, guarda el archivo intermedio para poder inspeccionarlo:

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

Abre output.org en Emacs y comprueba los niveles de los encabezados, los enlaces, los nombres de los lenguajes de código fuente, las tablas, las rutas de las imágenes y cualquier metadato de Org que deba añadirse manualmente. Para una conversión sin instalación, usa el convertidor gratuito de 101convert.com y descarga el archivo .org resultante.

Limitaciones de calidad y compatibilidad

El contenido estructural suele convertirse correctamente, pero los atributos de AsciiDoc, las secciones condicionales, los roles personalizados, los bloques passthrough, las extensiones de diagramas y las macros específicas del procesador pueden omitirse o reducirse a texto normal. Asciidoctor expande las inclusiones estándar durante el primer comando, pero los archivos incluidos deben estar disponibles y referenciarse mediante rutas relativas utilizables.

Las advertencias y los bloques con estilo de AsciiDoc pueden no corresponderse con construcciones nativas de Org; revísalos después de la conversión. Las tablas pueden requerir una alineación manual o una reescritura, y las referencias a imágenes siguen dependiendo de los archivos de recursos originales. DocBook es una representación intermedia, por lo que el estilo de AsciiDoc y el comportamiento específico del backend no se conservan exactamente.

Si el origen usa extensiones personalizadas de Asciidoctor, convierte primero un ejemplo representativo y compara el archivo de Org generado con el original antes de procesar un conjunto de documentos más grande.