Cómo convertir una imagen a Base64 y leer el resultado

PublicadoHerramientaConversor de Archivos Base64 (Codificador y Decodificador)

Contenido
  1. Por qué este resultado confunde: una situación habitual
  2. Cómo calcularlo tú mismo desde el principio, sin herramientas
  3. Puntos que suelen confundir al leer el resultado
  4. En resumen
  5. Preguntas frecuentes

A veces quieres insertar una imagen en HTML o CSS directamente como una cadena de texto en lugar de como un archivo. Otras veces necesitas tomar una cadena Base64 que recibiste de algún sitio y devolverla a su formato de archivo de imagen.

En ambos casos la gente suele atascarse en el mismo punto: por qué la cadena es más larga que el original, qué es exactamente el prefijo "data:image/png;base64,", y por qué la imagen que pegaste aparece rota.

Base64 no es un método de compresión: es una notación que transcribe datos binarios a texto.

Este artículo explica en orden cómo funciona esa notación, por qué el resultado pesa más que el original y cuándo conviene usar cada uno de los dos formatos de salida.

Resumen ① Base64 divide los datos binarios de 8 bits en bloques de 6 bits y los representa con 64 caracteres, así que el resultado es aproximadamente un 33 % más grande que el original. ② Una "Data URL" lleva el prefijo data:TipoMIME;base64, y se puede usar directamente en HTML/CSS; el "Plain Base64" contiene solo el valor codificado puro, sin ese prefijo. ③ Si pegas solo el Plain Base64 en una etiqueta img sin el prefijo, o si decodificas tal cual una cadena con espacios y saltos de línea mezclados, la imagen se rompe o se produce un error.

Por qué este resultado confunde: una situación habitual

Hay casos en los que quieres meter un icono pequeño entero dentro del HTML sin un archivo de imagen aparte. Por ejemplo, en entornos donde la carga de imágenes externas se bloquea a menudo, como las plantillas de correo electrónico, o cuando creas un widget que debe distribuirse en un solo archivo.

En esos casos se convierte la imagen a Base64 y se inserta como cadena dentro de <img src="...">.

El problema aparece cuando copias el resultado de la conversión y lo pegas tal cual, pero la imagen no se muestra. También ocurre lo contrario: guardas como archivo una cadena Base64 que recibiste del servidor y no sabes qué extensión ponerle.

Muchas veces la información del formato del archivo original no está en la propia cadena, y aunque esté, si no sabes dónde va no puedes usarla. Ambas situaciones se resuelven al instante si entiendes el principio de la codificación.

Cómo calcularlo tú mismo desde el principio, sin herramientas

El principio de cortar en bloques de 6 bits y convertirlos en caracteres

La clave de la codificación Base64 es volver a cortar en unidades de 6 bits los datos binarios que estaban almacenados en unidades de 8 bits. Ese valor de 6 bits (0–63) se asigna a una tabla predefinida de 64 caracteres (A–Z, a–z, 0–9, +, /).

El mínimo común múltiplo de 8 y 6 bits es 24 bits. Por eso, por cada 3 bytes del original (24 bits) se generan 4 grupos de 6 bits, es decir, 4 caracteres.

Por ejemplo, los valores de byte de la cadena "Man" son M=77, a=97, n=110. Si los unes en binario, obtienes 24 bits (010011010110000101101110).

Si los divides en 4 grupos de 6 bits, obtienes 19, 22, 5 y 46, que corresponden a T, W, F y u en la tabla de caracteres, de modo que "Man" se codifica como "TWFu".

Por qué aumenta el tamaño y el relleno con "="

Aquí queda expuesta tal cual la razón del aumento de tamaño. 3 bytes del original se convierten en 4 caracteres y, si guardas esos 4 caracteres como texto, vuelven a ocupar 4 bytes.

La proporción en que 3 bytes pasan a 4 bytes es 4/3, aproximadamente 1,333 veces. Esa es la base del cálculo de que "tras la codificación el tamaño crece alrededor de un 33 %".

Si el tamaño original no es divisible exactamente entre 3, se rellena el último hueco con el carácter "=". Si sobra 1 byte se añaden "==" al final, y si sobran 2 bytes se añade un solo "=", de modo que la longitud de salida siempre sea múltiplo de 4.

Convertir directamente desde la terminal

Si quieres hacer la conversión sin calcular a mano, puedes usar los comandos integrados en el sistema operativo. En una terminal de macOS o Linux, escribe lo siguiente.

base64 -i image.png

La cadena que aparece como resultado es el Plain Base64. Si conoces el tipo MIME del archivo, puedes añadirle delante un prefijo como "data:image/png;base64," y tendrás la Data URL completa.

Para el proceso inverso, devolver la cadena a un archivo, añade la opción -d al mismo comando.

Compruébalo con nuestra herramienta.

Conversor de Archivos Base64 (Codificador y Decodificador)

Al seleccionar un archivo se convierte al instante a Base64 dentro del navegador, sin enviarse a ningún servidor, y admite hasta 10 MB.

Puntos que suelen confundir al leer el resultado

La Data URL y el Plain Base64 contienen el mismo valor codificado, pero su uso se divide según tengan prefijo o no.

CategoríaData URLPlain Base64
Formadata:image/png;base64,iVBORw0K...iVBORw0K... (sin prefijo)
Dónde se usaLugares donde el navegador debe interpretarlo directamente, como <img src=""> o background-image en CSSLugares donde solo se necesita el valor codificado puro, como el cuerpo de una petición a una API o el guardado en un archivo
Información del tipo MIMEVa incluida en el prefijo, así que no hace falta pasarla aparteNo está en la propia cadena, hay que indicarla por separado

Los errores más frecuentes son tres.

Error 1: ponerlo en la etiqueta img sin el prefijo

Si copias solo la cadena Plain Base64 y la pones tal cual en <img src="...">, el navegador no puede interpretarla y solo aparece el icono de imagen rota.

En el atributo src siempre debes poner la Data URL completa, con el prefijo "data:TipoMIMEdeImagen;base64,".

Error 2: no saber la extensión original al decodificar

Si solo recibes la cadena Base64, puede parecer que no hay forma de saber qué formato tenía el archivo original.

Sin embargo, la mayoría de los formatos de archivo tienen una firma propia (número mágico) en los primeros bytes. Si revisas los primeros bytes del resultado decodificado, puedes deducir el formato: PNG, JPEG, GIF, PDF, etc.

Eso sí, existe la limitación de que si el formato no tiene firma o las firmas se solapan, no se puede saber la extensión exacta.

Error 3: decodificar tal cual una cadena con espacios y saltos de línea mezclados

La tabla de caracteres Base64 no incluye espacios ni saltos de línea.

En algunos sistemas, como el correo electrónico, existe la práctica de guardar los valores Base64 largos con saltos de línea cada 76 caracteres. Si metes tal cual en la función de decodificación una cadena con esos saltos de línea, se interpretan como caracteres no válidos y se produce un error o el resultado sale corrupto.

Si eliminas los espacios y los saltos de línea antes de decodificar, evitas este problema.

En resumen

  • Base64 es una notación que divide los datos de 8 bits en bloques de 6 bits y los representa con 64 caracteres; por esa estructura, el resultado es aproximadamente un 33 % (4/3 veces) más grande que el original.
  • Si el tamaño original no es múltiplo de 3 bytes, se rellena el hueco con el carácter "=" para que la longitud de salida sea múltiplo de 4.
  • Lo que lleva el prefijo "data:TipoMIME;base64," es la Data URL, y el valor codificado puro sin ese prefijo es el Plain Base64. Sus usos son distintos.
  • En la etiqueta img o en CSS se pone la Data URL completa, con prefijo incluido; si necesitas datos para guardar o transmitir, usa el Plain Base64.
  • Al leer el resultado de una decodificación, deduce el formato a partir de la firma de los primeros bytes, y limpia antes las cadenas con espacios y saltos de línea para interpretarlas sin errores.
Conversor de Archivos Base64 (Codificador y Decodificador)

Al seleccionar un archivo se convierte al instante a Base64 dentro del navegador, sin enviarse a ningún servidor, y admite hasta 10 MB.

Preguntas frecuentes

¿Al convertir a Base64 siempre crece exactamente un 33 %?

El principio es siempre una escala de 4/3, pero el aumento real varía un poco según el tamaño original y si hay relleno o no.

Cada 3 bytes se generan 4 caracteres, así que en teoría el aumento es de aproximadamente un 33,3 %. Si sobran 1 o 2 bytes y se añade el relleno "=", en archivos muy pequeños esa proporción puede subir ligeramente.

¿Cuál debo copiar, la Data URL o el Plain Base64?

En lugares donde el navegador debe renderizar la imagen de inmediato, como img src en HTML o background-image en CSS, copia la Data URL con prefijo.

Cuando solo necesitas el valor codificado puro, como en el cuerpo de una petición a una API o en un almacenamiento aparte, usa el Plain Base64 sin prefijo.

El archivo decodificado no se abre como imagen. ¿Por qué?

La causa más habitual es que la cadena original se copió cortada por el medio, o que se decodificó con espacios y saltos de línea mezclados.

Si el tipo MIME estimado no coincide con el formato real, la extensión no será la correcta y el visor de imágenes podría no abrir el archivo. Comprueba primero si la cadena original está completa y si el formato deducido a partir de la firma es el correcto; así acotarás la causa.

¿Qué es el símbolo "=" que aparece al final de la cadena Base64?

Es un carácter de relleno (padding). Base64 establece la regla de que la longitud del resultado siempre sea múltiplo de 4.

Cuando los datos originales no se dividen exactamente en múltiplos de 3 bytes, se rellenan los huecos restantes con "=" para ajustar la longitud. No es un valor de dato real, sino una marca para cuadrar el formato.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Convertir estilos inline en clases CSS: cómo funcionaAsí extrae la herramienta el atributo style, lo convierte en clases numeradas y genera una hoja CSS externa, sin borrar el class que ya tenías.
  2. Reglas de abreviatura IPv6: cómo leer :: y la forma expandidaAprende las reglas para abreviar IPv6: omitir los ceros iniciales de cada bloque, comprimir con :: una sola vez y expandir la dirección a sus 8 bloques.
  3. Comprimir JS online: cómo se calcula la tasa de compresiónPor qué el porcentaje de compresión de JS varía según la herramienta y cómo calcularlo y comprobarlo tú mismo con los bytes de entrada y salida.
  4. Ver un array JSON en tabla: encabezados, orden y búsquedaCómo se crean las columnas de un array JSON al verlo en tabla, con qué criterio se ordenan y buscan los valores y por qué da error si no es un array.
  5. Convertir JSON a lista HTML ul/li: reglas y erroresQué regla convierte cada elemento de un array JSON en texto de un li, cómo se aplican ul u ol y class, y por qué fallan el parseo o una clave mal escrita.
  6. JSON inválido: cómo leer el error y repararlo automáticamentePor qué JSON.parse falla con comentarios, comas finales o claves sin comillas, cómo leer line y position en el error y qué hace la corrección automática.

Herramientas relacionadas