Convertir Base64 a PDF y archivo · PDF a Base64

Base64 a PDF — respuestas rápidas

¿Qué es un PDF en Base64?

%PDF-1.4          → bytes 25 50 44 46 2D 31 2E 34
JVBERi0xLjQ=      → the same bytes in Base64
data:application/pdf;base64,JVBERi0xLjQ=   → data URI form

Funciones

Base64 a PDF en Python, Java, JavaScript y más

Ejemplos de Base64 a PDF

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4K…

PDF · versión 1.4 · descargado como file.pdf

"data:application\/pdf;base64,JVBERi0xLjQK…"

Interpretado así: comillas eliminadas → escapes JSON deshechos → prefijo data URI eliminado (application/pdf)

{"code":0,"data":{"name":"invoice.pdf","file":"JVBERi0xLjQK…"}}

Interpretado así: campo data.file extraído del JSON

data:application/pdf;base64,iVBORw0KGgoAAAANSUhEUgAA…

Aviso: la data URI dice application/pdf, pero los bytes son PNG. Guardado como file.png

255044462d312e370a…

Aviso: parece hexadecimal; leído como hex es un PDF. [Decodificar como hex]

Cómo convertir Base64 a PDF

1. 1

   Pega el Base64 tal como lo recibiste

   Base64 puro, data:application/pdf;base64,…, una cadena copiada de un JSON con escapes \/ o la respuesta completa de la API. Para cadenas muy largas usa Abrir un archivo .txt en lugar de pegar.

2. 2

   Comprueba cómo se interpretó

   La línea bajo el cuadro enumera cada paso de limpieza: prefijo eliminado, escapes deshechos, padding añadido, campo extraído del JSON. Si algo falla, el error indica el carácter exacto y su posición.

3. 3

   Revisa el tipo detectado y los avisos

   La etiqueta muestra el tipo leído de los bytes mágicos del archivo. Aparece una nota amarilla si en realidad no es un PDF, si la data URI miente sobre el tipo o si el PDF está cortado antes de %%EOF.

4. 4

   Previsualiza y descarga

   Los PDF se abren en el visor del propio navegador; las imágenes y el texto se muestran en la página. Cambia el nombre del archivo si quieres y haz clic en Descargar. Para el sentido inverso, cambia a PDF / archivo → Base64 y suelta un archivo.

Por qué no abre un PDF en Base64: errores comunes

base64.b64decode(value)  # value = 'data:application/pdf;base64,JVBERi0…'

b64 = value.split(',', 1)[1] if value.startswith('data:') else value
pdf = base64.b64decode(b64)

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64').toString())

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64'))

byte[] pdf = Base64.getDecoder().decode(wrapped);  // IllegalArgumentException

byte[] pdf = Base64.getMimeDecoder().decode(wrapped);

base64.b64decode(token_part)  # contains - and _

base64.urlsafe_b64decode(token_part + '=' * (-len(token_part) % 4))

new Blob([atob(b64)], { type: 'application/pdf' })

const bytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0));
new Blob([bytes], { type: 'application/pdf' })

SELECT LENGTH(pdf_b64) FROM docs;  -- 65535: suspiciously round

ALTER TABLE docs MODIFY pdf_b64 LONGTEXT;  -- or store the bytes in a BLOB

Cuándo necesitas convertir Base64 a PDF

Una API devuelve el PDF en Base64

Las API de facturación, firma electrónica e impresión de etiquetas suelen devolver documentos dentro de un JSON. Pega la respuesta para revisar el documento antes de escribir el código que lo guarda.

Depurar un PDF que no abre

Cuando el archivo guardado sale en blanco o dañado, pega aquí el mismo Base64. La herramienta te dice si está truncado, codificado dos veces, si ni siquiera es un PDF o si está bien, lo que significa que el fallo está en cómo tu código escribe el archivo.

Enviar un archivo en una petición JSON

Muchos endpoints de subida esperan {"filename": …, "content": "<base64>"}. Codifica aquí el archivo para montar una petición de prueba en Postman o cURL.

Incrustar un archivo en HTML, CSS o un correo

Genera una data URI para un enlace a un PDF en línea, una fuente o una imagen pequeña, o Base64 a 76 columnas para una parte MIME de un correo.

Recuperar adjuntos de logs y bases de datos

Los archivos guardados en una columna de texto o impresos en un log se pueden recuperar directamente, y si falta el %%EOF sabrás que la columna o la línea de log era demasiado corta.

Cómo funciona la codificación Base64 de archivos

Por qué el Base64 ocupa un 33% más

Cada carácter lleva 6 bits, así que 3 bytes (24 bits) necesitan 4 caracteres. Con padding, la longitud es 4 × ⌈n ÷ 3⌉: 100 KB (102.400 bytes) se convierten en 136.536 caracteres. El formato MIME añade un CRLF cada 76 caracteres, así que 1 MB pasa a 1.434.896 caracteres en lugar de 1.398.104.

Alfabeto estándar y alfabeto URL-safe

El RFC 4648 define dos alfabetos que solo difieren en los dos últimos caracteres: + / (estándar, sección 4) y - _ (seguro para URL y nombres de archivo, sección 5). El Base64 URL-safe suele omitir el padding =. Si una cadena mezcla los dos, se editó o se unió de dos fuentes.

Padding y longitudes imposibles

El padding = hace que la longitud sea múltiplo de 4. Sin él, un resto de 2 o 3 se puede restaurar; un resto de 1 es imposible en cualquier Base64 válido: se perdió o se añadió un carácter. Un = en medio suele indicar que se concatenaron dos cadenas.

Los bytes mágicos deciden el tipo

Un archivo declara su formato en sus primeros bytes: %PDF- en un PDF, 89 50 4E 47 en un PNG, 50 4B 03 04 en los formatos basados en ZIP como DOCX y XLSX. Esos bytes fijan los primeros caracteres del Base64, así que el tipo se puede leer antes de decodificar: consulta la tabla en la herramienta.

Cómo se detecta un PDF truncado

Un PDF termina en %%EOF. Si no aparece en los últimos 1.024 bytes, el archivo casi seguro se cortó. La cabecera puede empezar hasta 1.024 bytes más adelante; la mayoría de los lectores abren esos archivos igualmente, así que se avisa pero no se rechaza.

Buenas prácticas para enviar archivos en Base64

Envía el tipo MIME y el nombre del archivo junto con los datos

El Base64 no lleva nombre ni tipo. Pon ambos a su lado ({"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}) o usa una data URI, para que el receptor no tenga que adivinar.

Comprueba los bytes mágicos en el lado receptor

Antes de guardar, verifica que los bytes decodificados empiezan por %PDF-. Con una línea de código detectas campos equivocados, doble codificación y páginas de error devueltas en Base64.

Para archivos grandes, mejor multipart o una URL

Base64 añade un tercio al tamaño y la cadena entera tiene que estar en memoria. A partir de unos pocos megabytes, multipart/form-data o una URL de descarga prefirmada es más ligero para ambos extremos.

Guarda bytes, no Base64, en la base de datos

Una columna BLOB/bytea ocupa un tercio menos y no se puede truncar sin avisar como un VARCHAR. Codifica en Base64 solo en la frontera de la API.

Base64 a PDF — preguntas frecuentes