Cómo formatear JSON online

Una respuesta de API minificada o un archivo de configuración que te llega en una sola línea interminable es casi imposible de leer: llaves, comas y valores anidados se amontonan y encontrar el campo que buscas se convierte en una lotería. Formatear (también llamado embellecer o pretty-print) lo arregla añadiendo sangría y saltos de línea para que la estructura se vea de un vistazo. Para formatear JSON online, pega tu JSON en el formateador de JSON de Static.app, que es gratis, y pulsa Formatear: el resultado con sangría aparece en el panel de salida en segundos, sin instalar nada.

Qué significa "formatear" JSON

Formatear JSON cambia solo los espacios en blanco, nunca los datos. JSON no es sensible a los espacios, así que un analizador lee {"a":1,"b":[2,3]} exactamente igual que una versión repartida en diez líneas con sangría (RFC 8259, sección 2). Un formateador toma tu JSON y lo vuelve a escribir con una estructura coherente para que una persona pueda seguirlo.

• Sangría: cada nivel de anidación se desplaza una cantidad fija (lo habitual son 2 espacios, 4 espacios o un tabulador), de modo que los objetos y arrays anidados se ven escalonados.
• Saltos de línea: cada par clave/valor y cada elemento de un array va en su propia línea, en vez de todos juntos en una.
• Espaciado coherente: un único espacio después de cada dos puntos y de cada coma, aplicado de forma uniforme.
• Ordenar es opcional: al formatear no se reordenan las claves. Ordenarlas alfabéticamente es un paso aparte y opcional, y el formateador de JSON de Static.app conserva el orden original de las claves.

Por qué importa que el JSON sea legible

El JSON legible importa porque, con la salida formateada, depurar deja de ser adivinar y pasa a ser recorrer con la vista. Casi siempre te encuentras con JSON en bruto cuando algo ha fallado: un endpoint ha devuelto una estructura inesperada, el payload de un webhook no coincide con la documentación o un archivo de configuración da un error que no localizas. Si el JSON es una sola línea, no ves dónde termina un objeto ni a qué array pertenece un valor.

• Depurar respuestas de API: con la salida formateada recorres la estructura, compruebas que un campo existe y ves a qué profundidad está.
• Leer archivos de configuración: los manifiestos de paquetes, los ajustes de despliegue y las configuraciones de herramientas son mucho más fáciles de editar sin riesgo cuando se ve su jerarquía.
• Revisar diferencias: el JSON formateado produce un cambio por línea, así que las diferencias del control de versiones señalan exactamente qué ha cambiado.

Cómo formatear JSON online en el navegador

Formatear JSON online se hace en tres pasos en el formateador de JSON de Static.app: pegar, Formatear, copiar. No hay nada que instalar ni terminal de por medio.

Paso a paso

1. Pega tu JSON en el panel de entrada del formateador de JSON de Static.app, o usa Abrir archivo JSON para cargar un archivo .json de tu ordenador. También puedes soltar un archivo directamente sobre la entrada o pulsar Ejemplo para cargar primero un ejemplo pequeño.
2. Elige la sangría con el selector Sangría: 2 espacios, 4 espacios o Tabuladores. Por defecto está en 2 espacios, y con cuatro espacios es más fácil recorrer datos muy anidados.
3. Pulsa Formatear. El resultado, con la sangría bien aplicada, aparece al instante en el panel de salida.
4. Usa Copiar para quedarte con el JSON formateado o Descargar para guardarlo como archivo. Vaciar deja los dos paneles en blanco cuando termines.

Tus datos se quedan en tu navegador

Con JavaScript activado, el formateador funciona en el navegador: el formateo ocurre en tu equipo y no se sube nada a ningún servidor para procesarlo. Eso importa cuando el JSON que depuras contiene tokens de acceso, datos de clientes o configuración interna que preferirías no pegar en un servicio externo. Con JavaScript desactivado, el formulario se envía a nuestro servidor, así que déjalo activado para cualquier dato sensible.

Formatear, validar y minificar

Valida el JSON antes de formatearlo y minifícalo cuando lo publiques. Si tu JSON tiene un error de sintaxis, como una coma final o unas comillas que faltan, no se puede analizar y, por tanto, tampoco formatear. Si lo que pegas no se formatea, pásalo por el validador de JSON para localizar el problema exacto, corrige el error que te indique y vuelve a formatear. El minificador de JSON hace la operación contraria: quita de nuevo los espacios en blanco para que el payload ocupe lo mínimo posible al transmitirse, que es lo que quieres cuando ya has terminado de leer el JSON.

Preguntas frecuentes

Las cuatro respuestas siguientes explican si formatear cambia tus datos, si tu JSON se sube a algún sitio, qué sangría elegir y qué hacer cuando lo que pegas no se formatea.

¿Formatear cambia mis datos?

No. Formatear solo añade y ajusta espacios en blanco, así que los valores, las claves y la estructura quedan idénticos. Un analizador trata la salida formateada y el original como el mismo JSON. Lo único que cambia es lo fácil que resulta leerlo.

¿Mi JSON se sube a algún sitio?

No, siempre que tengas JavaScript activado. El formateador de JSON procesa entonces todo en local, en tu navegador, así que tus datos no se envían ni se guardan en ningún servidor, y sigue funcionando aunque se corte la conexión una vez cargada la página. Con JavaScript desactivado, el formulario se envía a nuestro servidor, así que déjalo activado para payloads sensibles.

¿Qué sangría debería usar?

Dos espacios es un valor muy extendido y evita que los objetos anchos y muy anidados se vayan demasiado hacia la derecha. Cuatro espacios separan más visualmente los niveles y los tabuladores dejan que cada persona controle el ancho en su propio editor. Elige la que siga la convención de tu proyecto.

¿Por qué no se formatea mi JSON?

Si la entrada no es JSON válido, no se puede analizar y el formateador de JSON de Static.app no puede reorganizarla. Las causas más habituales son comas finales, comillas simples en lugar de dobles, claves sin comillas o un comentario olvidado en el archivo. Pégalo en el validador de JSON para encontrar el punto exacto, corrígelo y vuelve a formatear.