Guía del formateador JSON
JSON (JavaScript Object Notation) es el formato más habitual para intercambiar datos entre servicios web, aplicaciones y archivos de configuración. Es fácil de leer para una máquina, pero una respuesta de API de 5.000 caracteres en una sola línea es casi imposible de revisar para una persona. Un formateador JSON (también llamado «beautifier» o «pretty printer») añade saltos de línea y sangría para que veas la estructura de un vistazo.
Esta herramienta combina un formateador, un validador JSON estricto (RFC 8259 / ECMA-404), un visor JSON y conversores en una sola página. A diferencia de la mayoría de herramientas JSON online, no se envía nada a un servidor: el código se ejecuta en tu navegador, así que es seguro para claves de API, datos de clientes y configuraciones internas.
Los errores JSON más comunes y cómo corregirlos
| Error | Incorrecto | Correcto |
|---|---|---|
| Comillas simples | {'nombre': 'Ana'} | {"nombre": "Ana"} |
| Coma final | {"a": 1, "b": 2,} | {"a": 1, "b": 2} |
| Clave sin comillas | {nombre: "Ana"} | {"nombre": "Ana"} |
| Falta una coma | {"a": 1 "b": 2} | {"a": 1, "b": 2} |
| Comentarios | {"a": 1 // nota} | {"a": 1} |
| Literales de Python | {"ok": True, "x": None} | {"ok": true, "x": null} |
| NaN / undefined | {"v": NaN} | {"v": null} |
| Salto de línea en cadena | "línea 1 ↵ línea 2" | "línea 1\nlínea 2" |
Pulsa Reparar y la herramienta corrige todo lo anterior automáticamente. Deshaz la reparación con Ctrl+Z.
Chuleta de JSONPath
Abre el filtro (icono de embudo sobre el resultado) y escribe una expresión. El resultado se actualiza mientras escribes.
| Expresión | Devuelve |
|---|---|
$.store.name | La propiedad name de store |
$.items[0] | El primer elemento |
$.items[-1] | El último elemento |
$.items[0:5] | Los cinco primeros elementos |
$.items[*].id | El id de cada elemento |
$..email | Cada email, a cualquier profundidad |
$.items[?(@.price < 10)] | Elementos que cuestan menos de 10 |
$.users[?(@.role == 'admin')].name | Nombres de todos los admins |
$.users[?(@.email =~ /gmail/i)] | Usuarios con dirección de Gmail |
$.items.length | Número de elementos |
JSON vs YAML vs XML vs CSV
| Formato | Ideal para | Anidación | Comentarios |
|---|---|---|---|
| JSON | APIs, aplicaciones web, bases NoSQL | Sí | No |
| YAML | Configuración (Docker, Kubernetes, CI) | Sí | Sí |
| XML | Sistemas empresariales, SOAP, RSS, archivos Office | Sí | Sí |
| CSV | Hojas de cálculo (Excel, Google Sheets), exportaciones | No (aplanado) | No |
Consejos
- Teclado: Ctrl+Intro formatea, Ctrl+Mayús+Intro minifica, Ctrl+F busca, Ctrl+S descarga (⌘ en Mac).
- Excel en España: el punto y coma ya viene seleccionado como separador CSV — así Excel reparte bien las columnas.
- Minifica antes de publicar: el JSON minificado suele ser un 20–40 % más pequeño — APIs más rápidas y bundles más ligeros.
- El JSON «stringificado» como
"{\"id\":1}"de los logs se detecta automáticamente — pulsa «Desescapar». - JSON Lines / NDJSON (un objeto JSON por línea, habitual en logs y exportaciones de BigQuery) se valida línea a línea.