Convertidor online gratuito de AD a MD

Markdown suele ser necesario para archivos README, repositorios de Git, sitios de documentación y edición ligera, mientras que algunos documentos de origen llegan como archivos AsciiDoc con la extensión más corta .ad. La conversión del archivo de origen conserva su contenido legible y adapta los encabezados, las listas, los enlaces, los bloques de código y las tablas a la sintaxis de Markdown.

Qué es el formato AD

En la categoría de archivos de texto, .ad suele identificar un archivo de origen AsciiDoc. AsciiDoc es un lenguaje de marcado de texto plano para documentación técnica, libros, manuales, archivos README y páginas web; el mismo lenguaje suele almacenarse con .adoc o .asciidoc.

Los archivos AsciiDoc se pueden crear con el procesador AsciiDoc original, Asciidoctor, editores de texto y sistemas de compilación de documentación. Contienen marcado de origen legible, como títulos de secciones, listas, enlaces, bloques de código fuente, advertencias, tablas, atributos y directivas include. La extensión por sí sola no es definitiva, por lo que debe confirmar que el archivo contiene sintaxis AsciiDoc antes de convertirlo.

Qué es el formato MD

.md identifica un archivo Markdown. Markdown utiliza caracteres de texto plano para encabezados, énfasis, enlaces, listas, citas, bloques de código y otras estructuras de documentos. GitHub, GitLab, los generadores de sitios estáticos, las aplicaciones para tomar notas, las plataformas de documentación y los editores de código suelen representar Markdown.

Markdown es útil cuando un documento debe seguir siendo fácil de leer sin un renderizador, funcionar bien con sistemas de control de versiones o aceptarse como archivo README o fuente de documentación. GitHub Flavored Markdown, conocido comúnmente como GFM, añade tablas, listas de tareas, texto tachado y bloques de código delimitados.

Cómo convertir realmente AD a MD

Uso de Asciidoctor y Pandoc

Para una conversión fiable, utilice Asciidoctor para interpretar el archivo de origen AsciiDoc y generar DocBook XML; después, utilice Pandoc para convertir ese archivo intermedio estructurado a Markdown GFM. Instale Asciidoctor y Pandoc, coloque el archivo de origen en el directorio de trabajo y ejecute:

1. Convierta el archivo AsciiDoc a DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Convierta el XML a Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Abra output.md en un editor de Markdown y compruebe los encabezados, los enlaces, las tablas, las imágenes, las listas y los bloques de código.

Para usar una canalización de shell de un solo paso, ejecute:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Uso del convertidor en línea integrado

Puede convertir el archivo de forma gratuita en 101convert.com sin instalar software: seleccione el formato de entrada AD, cargue input.ad, elija MD como formato de salida, inicie la conversión y descargue el archivo .md resultante.

Limitaciones de calidad y compatibilidad

La conversión cambia el marcado en lugar de limitarse a cambiar el nombre de la extensión. Los atributos de AsciiDoc, el contenido condicional, las macros, las referencias cruzadas, los diagramas incrustados y las estructuras complejas de tablas o advertencias pueden requerir edición manual después de la conversión.

Utilice rutas que sigan siendo válidas desde la ubicación del archivo Markdown. Es posible que deba corregir las referencias a imágenes, y que se descarten los roles o atributos específicos de AsciiDoc porque Markdown estándar no tiene un equivalente. La salida GFM suele ser el destino más compatible para GitHub y GitLab, mientras que Markdown básico es preferible cuando el destino solo admite la sintaxis original.

Las directivas include de AsciiDoc y las sustituciones de origen pueden afectar al resultado generado. Revise la salida después del preprocesamiento, especialmente cuando el archivo de origen utilice archivos externos, atributos personalizados o rutas relativas de imágenes.