Convertidor online gratuito de ASCIIDOC a PDF

Qué es el formato ASCIIDOC

AsciiDoc es un formato de marcado de texto plano para documentos estructurados, como manuales de software, archivos README, libros, artículos y especificaciones técnicas. Los autores escriben archivos de origen legibles con encabezados, listas, bloques de código delimitados, tablas, atributos, referencias cruzadas y extensiones opcionales; las extensiones de nombre de archivo comunes son .adoc y .asciidoc.

Los archivos AsciiDoc suelen crearse en editores de texto, entornos de desarrollo integrados, repositorios de documentación y sistemas que utilizan Asciidoctor o el procesador AsciiDoc original. El origen sigue siendo editable y compatible con el control de versiones, pero su apariencia final depende del convertidor, el tema, las fuentes, los recursos de imagen y los atributos del documento.

Qué es el formato PDF

PDF almacena páginas con su diseño, fuentes, gráficos y dimensiones imprimibles conservados en distintos sistemas operativos. Es adecuado para documentación formal, archivos adjuntos de correo electrónico, impresión, registros y revisiones, ya que, por lo general, los destinatarios no necesitan el editor de origen ni la cadena de herramientas de AsciiDoc.

PDF es menos práctico que AsciiDoc para editar y comparar versiones automáticamente. También puede ser más grande que el archivo de origen, especialmente cuando incorpora fuentes o imágenes de alta resolución.

Cómo convertir ASCIIDOC a PDF

El método de línea de comandos más directo es Asciidoctor PDF, el convertidor de PDF para la cadena de herramientas Asciidoctor basada en Ruby.

1. Instala Ruby si aún no está disponible.
2. Instala el convertidor con gem install asciidoctor-pdf --pre. La opción --pre puede ser necesaria para el paquete de pre lanzamiento actual; omítela al instalar la versión estable más reciente.
3. Abre una terminal en el directorio que contiene el archivo de origen y ejecuta asciidoctor-pdf manual.adoc -o manual.pdf.
4. Abre manual.pdf en un visor de PDF y comprueba los saltos de página, las tablas, los bloques de código, los enlaces y las imágenes.

Para un archivo de origen que haga referencia a imágenes o incluya otros archivos AsciiDoc, ejecuta el comando desde el directorio del proyecto del documento y conserva su estructura de carpetas relativa. Usa -a toc=left o -a toc=macro para añadir una tabla de contenido, y -a pdf-theme=custom-theme.yml para aplicar un tema de PDF personalizado. El título, el autor y la revisión pueden establecerse en el encabezado del documento con atributos como = Installation manual, Author Name <author@example.com> y :revnumber: 1.2.

También puedes convertir el archivo gratis en el sitio web 101convert.com sin instalar software. Sube el archivo AsciiDoc, elige PDF como formato de salida, inicia la conversión y descarga el documento generado.

Consideraciones sobre calidad y compatibilidad

La sintaxis de AsciiDoc es procesada por un convertidor en lugar de copiarse directamente en PDF, por lo que las extensiones no compatibles, las macros personalizadas, las rutas de inclusión y el contenido condicional pueden cambiar el resultado. Asciidoctor PDF utiliza el directorio de trabajo actual y los atributos del documento para resolver las inclusiones y los recursos; las rutas faltantes producen resultados incompletos o advertencias.

Para lograr una paginación predecible, incorpora las fuentes o configúralas explícitamente, establece el tamaño de página y los márgenes en un tema de PDF y utiliza dimensiones de imagen orientadas a la impresión. Comprueba los diagramas, los archivos SVG, los enlaces externos, las notas al pie, el desbordamiento de las tablas y los caracteres de derecha a izquierda o no latinos después de la conversión. Un archivo de origen puede convertirse correctamente y aun así producir tablas recortadas o glifos faltantes si la fuente seleccionada no contiene los caracteres necesarios.