Convertidor online gratuito de JPG a ADOC

Formato de origen

JPG (o JPEG) es un formato de imagen raster ampliamente utilizado, diseñado para fotografías y otras imágenes de tono continuo. Es compatible con prácticamente todos los dispositivos, cámaras, navegadores y editores de imágenes. JPG utiliza compresión con pérdida, que mantiene los tamaños de archivo pequeños pero puede reducir la calidad de la imagen después de guardados repetidos. Se usa comúnmente para fotos, capturas de pantalla, gráficos web y para compartir imágenes.

Formato de destino

ADOC es un formato de documento de texto plano AsciiDoc utilizado para escribir documentación técnica, manuales, libros y documentación de software. Es popular entre desarrolladores y redactores técnicos porque es fácil de editar en cualquier editor de texto, funciona bien con el control de versiones y puede convertirse en HTML, PDF, EPUB y otros formatos de publicación. En comparación con archivos de imagen binarios, ADOC es legible por humanos y está estructurado con marcado.

Cómo realizar la conversión

Convertir JPG a ADOC no es una transformación directa de formato en el sentido habitual, porque una imagen JPG no contiene texto editable. En la práctica, la conversión significa crear un archivo AsciiDoc que referencia o incrusta la imagen. El mejor enfoque es escribir un documento ADOC pequeño y colocar el JPG junto a él.

1. Coloca el archivo JPG en la misma carpeta que tu documento, o anota su ruta.
2. Crea un nuevo archivo de texto llamado document.adoc en un editor de texto plano.
3. Agrega una referencia de imagen como image::photo.jpg[] para incrustar la imagen en AsciiDoc.
4. Si quieres un pie de foto, usa .Caption text en la línea encima del macro de la imagen.
5. Guarda el archivo con la extensión .adoc.

Contenido de ejemplo para document.adoc:

= My document .Caption text image::photo.jpg[]

Si quieres crear el archivo con un editor de escritorio, abre un editor de texto plano como VS Code, Notepad++, o cualquier editor de código, y luego guarda el archivo como .adoc. Si necesitas generar un documento a partir de la imagen automáticamente, también puedes usar primero software OCR para extraer texto del JPG y luego colocar ese texto en el marcado de AsciiDoc.

Puedes convertir el archivo en 101convert.com de forma gratuita, sin instalar ningún software.

Notas sobre calidad y limitaciones

La limitación principal es que JPG es un formato de imagen, no un documento de texto, así que no existe una conversión real de un solo clic a contenido significativo en AsciiDoc. Si el JPG contiene texto, necesitarás OCR para convertir la imagen en texto editable antes de guardarla como ADOC. La precisión del OCR depende de la calidad de la imagen, la claridad de la fuente, el contraste y la resolución.

Si tu objetivo es solo mostrar la imagen dentro de AsciiDoc, la conversión es sencilla: el archivo ADOC guarda una referencia al JPG en lugar de convertir los píxeles. Mantén el JPG en una ubicación estable en relación con el archivo ADOC para que los enlaces no se rompan. Para la publicación, los procesadores de AsciiDoc como Asciidoctor renderizarán correctamente el JPG referenciado en la salida HTML o PDF, siempre que la ruta de la imagen sea válida.