Convertidor online gratuito de ASCIIDOC a TEXTILE

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado ligero almacenado como texto plano, normalmente con las extensiones .adoc o .asciidoc. Admite títulos de documentos, secciones, admoniciones, tablas, referencias cruzadas, atributos, listados de código fuente, imágenes e inclusiones.

Los archivos se crean y procesan con Asciidoctor, el procesador AsciiDoc antiguo, AsciidocFX, Antora y editores de texto. Los proyectos de documentación, los archivos README, los manuales, las notas de lanzamiento y los archivos fuente de sitios estáticos lo utilizan habitualmente. La sintaxis de AsciiDoc varía entre implementaciones, y las extensiones de Asciidoctor pueden añadir características que no forman parte del formato básico.

Qué es el formato TEXTILE

Textile es un lenguaje de marcado de texto plano utilizado por algunas wikis, sistemas de gestión de contenido, herramientas de publicación y aplicaciones web antiguas. Su sintaxis utiliza marcadores breves como h1. Heading para los encabezados, *bold* para el texto en negrita, _italic_ para la cursiva y "link text":https://example.com para los enlaces.

Textile sigue siendo útil cuando la aplicación de destino tiene un analizador de Textile, pero no admite AsciiDoc. Al ser texto plano, el archivo convertido puede editarse con cualquier editor de texto y versionarse sin un formato de documento binario. Las implementaciones de Textile difieren en la compatibilidad con tablas, atributos, notas al pie y sintaxis extendida.

Cómo convertir realmente ASCIIDOC a TEXTILE

Para realizar una conversión rápida sin instalar software, utiliza el convertidor de 101convert.com: carga el archivo .adoc o .asciidoc, selecciona TEXTILE como formato de salida, inicia la conversión y descarga el archivo .textile resultante.

Para realizar una conversión local y repetible, utiliza Asciidoctor para crear DocBook XML y Pandoc para crear Textile. Pandoc no analiza de forma fiable todos los dialectos de AsciiDoc directamente, por lo que esta ruta en dos etapas permite que Asciidoctor se encargue de interpretar la sintaxis de origen.

1. Instala Asciidoctor y Pandoc utilizando el método de instalación de paquetes adecuado para tu sistema operativo.
2. Abre una terminal en el directorio que contiene el archivo de origen.
3. Ejecuta asciidoctor -b docbook5 -o intermediate.xml input.adoc. Sustituye input.adoc por el nombre de archivo real. Utiliza input.asciidoc cuando esa sea la extensión del archivo de origen.
4. Convierte el documento intermedio con pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Abre output.textile en un editor de texto o impórtalo en la aplicación Textile de destino y revisa el resultado renderizado.

Si el origen utiliza inclusiones locales, ejecuta Asciidoctor desde el directorio del proyecto para que las rutas relativas se resuelvan correctamente. Por ejemplo, asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc puede requerir que las rutas de inclusión y los atributos del proyecto estén disponibles desde ese directorio de trabajo.

Limitaciones de calidad y compatibilidad

El paso intermedio de DocBook puede cambiar los detalles de presentación. Los atributos de AsciiDoc, los bloques condicionales, los roles personalizados, las extensiones, el estilo de las admoniciones, las referencias cruzadas no resueltas y las macros específicas del procesador pueden omitirse o representarse de forma diferente en Textile.

Revisa las tablas, las listas anidadas, el formato en línea, las imágenes, las notas al pie, los anclajes, los bloques de código fuente y los enlaces después de la conversión. Normalmente, las imágenes se referencian mediante una ruta en lugar de incrustarse, por lo que debes copiar los archivos de imagen y conservar la estructura de directorios relativa. Es posible que un renderizador de Textile no admita todas las características producidas por Pandoc; las construcciones no compatibles pueden aparecer como marcado escapado o como párrafos normales.

Conserva el archivo AsciiDoc original como fuente autorizada. Edita el resultado de Textile únicamente cuando el sistema de destino requiera un ajuste puntual, ya que repetir la conversión sobrescribirá esos cambios.