Convertidor online gratuito de PNG a ADOC

Formato de origen: PNG

PNG (Portable Network Graphics) es un formato de imagen raster ampliamente utilizado para capturas de pantalla, logotipos, diagramas, iconos y gráficos web. Admite compresión sin pérdidas y transparencia, lo que lo convierte en una opción habitual cuando la calidad de la imagen y los bordes nítidos son importantes. Los archivos PNG normalmente los crean editores gráficos, herramientas de captura de pantalla, cámaras con opciones de exportación y software de diseño.

Formato de destino: ADOC

ADOC es un archivo de documento AsciiDoc, un formato de texto plano usado para escribir documentación técnica, manuales, archivos README y libros. Sus principales ventajas son la legibilidad, el control de versiones sencillo y la publicación flexible a formatos como HTML, PDF y EPUB. A diferencia de PNG, ADOC no es un formato de imagen; es un formato de marcado basado en texto, así que convertir PNG a ADOC normalmente significa incrustar la imagen dentro de un documento AsciiDoc o crear un archivo AsciiDoc que referencie la imagen.

Cómo realizar la conversión

La mejor estrategia depende de lo que quieras que contenga el archivo ADOC:

1. Si quieres un archivo AsciiDoc que muestre la imagen PNG

Crea un nuevo archivo .adoc e inserta una macro de imagen que apunte al archivo PNG:

image::picture.png[]

Si la imagen está en una subcarpeta, usa una ruta relativa como image::images/picture.png[].

Puedes crear o editar el archivo en cualquier editor de texto, como VS Code, Notepad++ o Vim. Guárdalo con la extensión .adoc.

2. Si quieres convertir el PNG en contenido de documentación

Abre el PNG en un visor o editor de imágenes y descríbelo manualmente en AsciiDoc. Por ejemplo, una captura de pantalla se puede convertir en documentación paso a paso con encabezados, listas y la imagen incluida como figura.

3. Si quieres previsualizar o publicar el resultado

Usa un procesador AsciiDoc como Asciidoctor para renderizar el archivo:

asciidoctor file.adoc

Esto genera salida HTML de forma predeterminada. Si necesitas PDF u otros formatos, usa el backend o la cadena de herramientas de Asciidoctor correspondiente.

Usar el convertidor en línea integrado

Puedes convertir el archivo en 101convert.com de forma gratuita, sin instalar ningún software. Sube el PNG, elige ADOC como formato de destino y descarga el resultado generado. Esto es conveniente para conversiones rápidas, especialmente cuando solo necesitas un archivo AsciiDoc sencillo que referencie o empaquete la imagen.

Notas sobre calidad, compatibilidad y limitaciones

PNG a ADOC no es una conversión real de imagen a texto. ADOC no puede almacenar datos de píxeles como lo hace PNG, así que el resultado suele ser o bien un envoltorio AsciiDoc alrededor de la imagen, o un documento escrito manualmente que describe la imagen. Si necesitas OCR para extraer texto de una captura de pantalla, usa primero una herramienta OCR y luego coloca el texto reconocido en el archivo ADOC.

Para una mejor compatibilidad, mantén el archivo PNG en la misma carpeta que el archivo .adoc o usa una ruta relativa correcta. Al publicar, asegúrate de que la imagen sea accesible para el procesador AsciiDoc. Los archivos PNG grandes pueden aumentar el tamaño del documento y ralentizar el renderizado, mientras que los PNG transparentes generalmente funcionan bien en la salida de AsciiDoc.

Si tu objetivo es editar la imagen en sí, conviértela a un formato de edición raster en su lugar; ADOC está pensado para documentación, no para edición de imágenes.