Convertidor online gratuito de ASCIIDOC a TYP

Typst requiere documentos fuente en su formato de marcado .typ, mientras que muchos proyectos de documentación se crean como archivos .adoc o .asciidoc. Convertir entre ellos permite reutilizar documentación estructurada en un flujo de publicación de Typst sin recrear manualmente cada encabezado, lista y referencia.

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado de texto plano para documentación técnica, manuales, archivos README, libros y páginas web. Los archivos suelen utilizar .adoc o .asciidoc; Asciidoctor y Asciidoctor.js los crean y procesan. El formato admite encabezados, listas, tablas, bloques de código fuente, referencias cruzadas, atributos, inclusiones, advertencias, imágenes y metadatos de documentos.

Qué es el formato TYP

En la categoría de archivos de texto, .typ indica el marcado fuente de Typst. Typst es un sistema de composición tipográfica cuyo compilador convierte archivos fuente en PDF y otras salidas renderizadas. Los archivos TYP combinan una sintaxis fuente legible con instrucciones de diseño para encabezados, figuras, tablas, citas, configuración de página y funciones reutilizables. Son útiles cuando el flujo de trabajo de destino utiliza el compilador de Typst en lugar de un renderizador de AsciiDoc o una cadena de herramientas de LaTeX.

Cómo convertir realmente ASCIIDOC a TYP

La ruta automatizada más fiable es convertir de Asciidoctor a DocBook XML y, a continuación, utilizar Pandoc para convertir a Typst. Instala Asciidoctor y una versión actual de Pandoc y, después, ejecuta:

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Sustituye document.adoc por el nombre del archivo fuente. El primer comando expande la estructura de AsciiDoc a DocBook; el segundo asigna los elementos de DocBook al marcado de Typst. Compila el resultado con:

typst compile document.typ

Para un archivo AsciiDoc que dependa de atributos, establécelos durante la conversión, por ejemplo:

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

También puedes utilizar el conversor gratuito de 101convert.com sin instalar software: selecciona el formato fuente ASCIIDOC, carga el archivo, elige TYP y guarda el resultado convertido.

Limitaciones de calidad y compatibilidad

Esta es una traducción de marcado, no un cambio de formato a nivel de bytes. Los encabezados básicos, párrafos, énfasis, listas, tablas, bloques de código y muchos enlaces suelen transferirse correctamente, pero los atributos de AsciiDoc, el contenido condicional, los roles personalizados, las macros, las extensiones, las inclusiones y los bloques de diagramas pueden requerir una reescritura manual en Typst.

Resuelve las inclusiones y genera los recursos externos antes de la conversión siempre que sea posible. Comprueba las rutas de las imágenes, los anchos de las tablas, las citas, la configuración de página y las referencias cruzadas en el archivo .typ generado. Pandoc puede conservar el contenido y, al mismo tiempo, cambiar la semántica del diseño, por lo que debes compilar el archivo con Typst e inspeccionar el PDF renderizado en lugar de basarte únicamente en el código fuente convertido.