Convertir JSON a PDF

Un cliente, una impresora, un sistema de registros o un flujo de trabajo de correo electrónico puede requerir un documento de diseño fijo en lugar de un archivo de datos. La conversión del archivo produce una instantánea legible para compartir, imprimir o archivar, pero no convierte automáticamente los datos anidados en un informe bien diseñado.

Qué es el formato JSON

JSON (JavaScript Object Notation) es un formato de texto plano e independiente del lenguaje para objetos, arrays, cadenas, números, valores Boolean y null. Las API web, la configuración de aplicaciones, el software de navegador, las bases de datos, las herramientas de exportación, los registros, los catálogos de productos y los scripts de desarrollador suelen crear archivos .json.

JSON conserva los valores de los datos y las relaciones anidadas, pero no define fuentes, tamaños de página, encabezados, tablas, saltos de página ni otras reglas de diseño de impresión. Por lo tanto, un conversor debe elegir cómo presentar la estructura.

Qué es el formato PDF

PDF es un formato de documento orientado a páginas diseñado para conservar el texto, los gráficos, las fuentes y el diseño en distintos sistemas operativos e impresoras. Es adecuado para informes, facturas, formularios, copias para clientes y registros que los destinatarios deben ver o imprimir sin modificar los datos subyacentes.

PDF es menos adecuado para ordenar, filtrar o reutilizar valores. Conserva el archivo .json original o proporciona una exportación CSV junto con el PDF cuando los destinatarios necesiten datos legibles por máquina.

Generar un PDF con formato con Python y un navegador

Este flujo de trabajo local evita cargar el código fuente y permite controlar los encabezados, las tablas, el espaciado y el escape de caracteres. Es adecuado para documentos JSON pequeños y de tamaño moderado.

1. Instala Python 3 y guarda el código fuente como data.json.
2. Guarda este script como json_to_pdf.py en el mismo directorio:

import html
import json
from pathlib import Path

source = json.loads(Path("data.json").read_text(encoding="utf-8"))

def render(value):
    if isinstance(value, dict):
        rows = []
        for key, item in value.items():
            rows.append(
                f"<tr><th>{html.escape(str(key))}</th>"
                f"<td>{render(item)}</td></tr>"
            )
        return "<table>" + "".join(rows) + "</table>"
    if isinstance(value, list):
        return "<ol>" + "".join(
            f"<li>{render(item)}</li>" for item in value
        ) + "</ol>"
    if value is None:
        return "<em>null</em>"
    return html.escape(str(value))

page = f"""<!doctype html>
<html><head><meta charset='utf-8'>
<title>JSON report</title>
<style>
body {{ font: 11pt Arial, sans-serif; margin: 15mm; color: #222; }}
table {{ border-collapse: collapse; width: 100%; margin: 0 0 14px; }}
th, td {{ border: 1px solid #999; padding: 6px; vertical-align: top; text-align: left; }}
th {{ width: 25%; background: #eee; }}
li {{ margin: 4px 0; }}
</style></head><body>
<h1>JSON report</h1>{render(source)}
</body></html>"""

Path("json_report.html").write_text(page, encoding="utf-8")

3. Ejecuta python json_to_pdf.py. En algunas instalaciones de Windows, utiliza py json_to_pdf.py.
4. Abre json_report.html en Chrome, Edge, Firefox o Safari y selecciona Print → Save as PDF o la opción de salida PDF del navegador.
5. Inspecciona la vista previa para comprobar si hay columnas cortadas, tablas divididas, espacios en blanco excesivos y caracteres ausentes. Activa los gráficos de fondo si deben aparecer los encabezados grises de las tablas.

El script escapa los caracteres sensibles a HTML, por lo que los valores que contienen markup se muestran como texto en lugar de interpretarse como HTML. Representa los objetos como tablas anidadas de dos columnas y los arrays como listas numeradas; un conjunto de datos grande o profundamente anidado puede necesitar una plantilla personalizada que seleccione campos o aplane los registros.

Usar un conversor en línea para datos no confidenciales

Servicios como CloudConvert y Convertio pueden aceptar un archivo JSON y devolver un PDF cuando esa conversión está disponible en su interfaz actual. Carga el archivo, selecciona PDF como destino, inicia la conversión y revisa el resultado descargado. Estos servicios pueden producir un listado de código sin formato o páginas con un formato mínimo en lugar de un informe, así que comprueba la vista previa y la selección de texto.

No cargues credenciales, información personal, exportaciones propietarias ni registros regulados a menos que las condiciones de seguridad, conservación y procesamiento del proveedor cumplan tus requisitos. Un flujo de trabajo local es más seguro para los datos confidenciales.

Imprimir JSON con formato desde un editor de escritorio

Para obtener una copia orientada a desarrolladores, abre el archivo en Visual Studio Code, ejecuta Format Document, luego selecciona File → Print y elige una impresora PDF o la salida PDF del sistema. Un editor compatible con JSON, como Notepad++ con un plugin de formato JSON, admite el mismo enfoque. Esto conserva la indentación y la sintaxis, pero normalmente crea un listado de código, no un informe basado en tablas.

Limitaciones de calidad y compatibilidad

• Valida el código fuente antes de la conversión. Ejecuta python -m json.tool data.json; un JSON con formato incorrecto hace que Python y la mayoría de los servicios de conversión se detengan.
• El orden de los miembros de un objeto JSON no tiene un significado general de presentación, y los nombres de miembros duplicados no son portables. Ordena las claves o los registros en el script cuando sea importante obtener un resultado repetible.
• Las cadenas largas y los objetos anchos pueden desbordar las páginas. Selecciona los campos relevantes, ajusta el texto, reduce el tamaño de la fuente o crea tablas independientes para las colecciones principales.
• Los caracteres Unicode requieren fuentes adecuadas. Si un navegador sustituye una fuente o el PDF carece de un glifo necesario, los caracteres pueden aparecer como cuadrados; utiliza una fuente con el script requerido y verifica el PDF exportado.
• Los datos Base64, Markdown, las URL y el markup incrustado son valores, no imágenes ni contenido con formato automáticamente. Añade un procesamiento explícito si esos valores necesitan una representación especial.
• Los PDF generados por navegadores normalmente contienen texto seleccionable y en el que se pueden realizar búsquedas. Una captura de pantalla o una impresión escaneada crea páginas compuestas únicamente por imágenes y puede requerir OCR.