Cómo convertir JSON o YAML a PDF: tabla, gráfico, árbol o código

Cómo convertir JSON o YAML a PDF

Para convertir JSON o YAML a PDF, sube el archivo .json, .yaml o .yml en la herramienta Convertir JSON o YAML a PDF, elige cómo presentar los datos (Tabla, Gráfico, Árbol o Código) y pulsa "Generar PDF y descargar". El PDF sale en A4 (la Tabla, en A4 apaisado), con encabezado, fecha y numeración de páginas, y el texto sigue siendo seleccionable y buscable. Todo funciona en el navegador, sin enviar el archivo a ningún servidor.

Es la salida para quien necesita adjuntar una configuración, la respuesta de un sistema o una lista de datos a un ticket, un informe o un correo sin volcar texto crudo y desalineado. La herramienta lee el archivo, descubre qué presentaciones admite y sugiere la mejor. Si el archivo es un texto, un Markdown o una página HTML, el conversor es otro: mira cómo convertir TXT, Markdown o HTML a PDF.

Cuatro maneras de presentar los mismos datos

En cuanto entra el archivo, el panel analiza el contenido y muestra solo los modos que tienen sentido para él. La sugerencia automática sigue este orden: Tabla, cuando los datos son una lista de elementos; Árbol, cuando hay datos anidados; Código, para cualquier archivo. Puedes cambiar el modo antes de generar.

• "Tabla": los datos son una lista de elementos y se convierten en una tabla con columnas y filas, con el encabezado destacado y repetido en cada página. Solo aparece cuando el archivo es una lista de registros parecidos. Un valor anidado dentro de una celda se vuelve un resumen, como "[3 itens]" o "{2 campos}" (el resumen sale en portugués).
• "Gráfico": una columna numérica se vuelve un gráfico. Eliges la "Columna de valor (números)", la "Columna de etiqueta" y el "Tipo de gráfico": Barras, Línea o Circular. Solo aparece cuando existe al menos una columna de números. Las barras son horizontales y siguen en páginas nuevas cuando hay muchas filas; Línea y Circular caben en una sola página, y en el Circular los valores cero quedan fuera.
• "Árbol": datos anidados en una vista indentada, más fácil de leer que el archivo crudo. Con Árbol seleccionado, aparece dentro de "Apariencia (opcional)" la casilla "Incluir un índice de secciones": el PDF recibe, al inicio, un índice con las secciones principales y la página de cada una.
• "Código": el archivo completo, coloreado por tipo (claves, textos, números), tal como fue escrito, en fuente monoespaciada y con la indentación conservada.

Si el archivo no es una lista de elementos, el modo Tabla no se ofrece; si no hay columna numérica, el Gráfico queda fuera. Cuando ni Tabla ni Árbol encajan (un archivo con un único valor, por ejemplo), el selector de modo ni siquiera aparece y el PDF sale en Código. Con varios archivos a la vez, el análisis usa solo el primero y el modo elegido vale para todos; si otro archivo no encaja en él, aparece un aviso como "Estos datos no forman una tabla. Usa el modo Código." y la generación se detiene en ese archivo.

Paso a paso para generar el PDF

1. Abre la herramienta "Convertir JSON o YAML a PDF".
2. Sube el archivo .json, .yaml o .yml; la herramienta analiza el contenido y marca el modo sugerido.
3. Elige cómo presentarlo: "Tabla", "Gráfico", "Árbol" o "Código". En Gráfico, define la columna de valor, la de etiqueta y el tipo (Barras, Línea o Circular).
4. Abre "Apariencia (opcional)" para elegir el "Tema" (Claro, Oscuro, Corporativo o Impresión, que ahorra tinta) y subir un "Logo en el encabezado" en PNG o JPG. Con Árbol seleccionado, aquí es donde está la casilla "Incluir un índice de secciones".
5. Pulsa "Generar PDF y descargar". El archivo se descarga con el nombre original y la extensión .pdf; con varios archivos el botón dice "Generar N PDF" y sale un PDF por archivo.

En cualquier modo, el PDF recibe un encabezado con el nombre del archivo y la fecha de generación (en formato día/mes/año), el logo si subiste uno, y la numeración de páginas en el pie, como "1 / 3". El texto se dibuja como texto, no como imagen: puedes seleccionarlo, copiarlo y buscarlo en el lector de PDF. El contenido largo se reparte en varias páginas en lugar de perderse por el margen.

Apariencia: temas y logo

• Claro: fondo blanco y colores vivos por tipo de dato, el predeterminado para leer en pantalla e imprimir a diario.
• Oscuro: fondo oscuro con paleta ajustada, para leer en pantalla.
• Corporativo: tonos más sobrios, pensado para informes y adjuntos formales.
• Impresión (ahorra tinta): tonos de gris, sin colores fuertes, para imprimir muchas páginas.
• Logo en el encabezado: PNG o JPG, mostrado arriba en cada página, junto al nombre del archivo y la fecha. Si la imagen no se puede leer, el PDF sale sin logo, sin aviso.

Cuándo generar un PDF a partir de los datos

• Documentar la configuración de un sistema y guardarla junto con el resto del papeleo de un proyecto.
• Adjuntar un archivo de datos a un ticket, un informe o un correo sin depender de que el destinatario tenga un editor de código.
• Registrar el estado de una configuración en un momento concreto, como un comprobante legible y fechado.
• Presentar una lista de registros como tabla o gráfico en una reunión, para quienes no abren JSON o YAML en el día a día.

JSON y YAML: cuál usar

Los dos formatos representan los mismos datos de maneras distintas. El JSON es el estándar de intercambio entre sistemas; el YAML es más compacto y común en archivos de configuración, porque es fácil de leer y escribir a mano. La herramienta acepta los dos y aplica los mismos modos y temas, así que usa el que ya tengas. Si el archivo es la respuesta de un sistema, probablemente es JSON; si es la configuración de un programa, muchas veces es YAML. Para pasar de un formato al otro antes de generar el PDF, mira cómo convertir JSON a YAML, YAML a JSON y XML a JSON.

Límites que conviene conocer

No hay elección de tamaño de papel ni de fuente: el PDF sale siempre en A4, vertical en los modos Código, Árbol y Gráfico y apaisado en la Tabla. Las letras fuera del alfabeto latino, como chino, japonés y emojis, desaparecen del PDF sin aviso, porque la fuente incrustada cubre solo el alfabeto latino con acentos. El modo Gráfico traza una serie a la vez, a partir de una columna numérica; para comparar varias columnas, genera un PDF por cada una. Un archivo JSON o YAML con error de sintaxis no se convierte: aparece "No se pudo leer este JSON. Comprueba que esté bien formado." o "No se pudo leer este YAML. Revisa la indentación y la sintaxis."

La conversión ocurre por completo en tu navegador: el archivo se procesa en tu propio dispositivo y nunca se envía a ningún servidor.

Para saber si aparecerá la Tabla: el archivo debe ser una lista de elementos con los mismos campos, como una lista de productos o de personas. Un objeto único con secciones anidadas va a Árbol o Código.