Cómo utilizarlo
- Pega tu código JSON en el cuadro de entrada de la izquierda (o haz clic en «Cargar ejemplo» para probarlo).
- Elige una sangría de 2 espacios o de 4 espacios.
- Haz clic en «Formato» para mejorar el aspecto, o en «Minimizar» para comprimirlo en una sola línea.
- Si el JSON no es válido, lee el mensaje de error que aparece debajo de los cuadros para identificar el problema.
- Haz clic en «Copiar» para copiar el resultado en el portapapeles.
Ejemplo
Entrada
{"name":"CodeKitHub","tools":["json","base64"],"free":true}Resultado
{
"name": "CodeKitHub",
"tools": [
"json",
"base64"
],
"free": true
}Los mismos datos, con una sangría de dos espacios. Minify hace lo contrario: elimina todos los espacios en blanco.
¿Qué es esta herramienta?
Un formateador de JSON toma texto JSON sin procesar, minificado o desordenado y lo reescribe con sangrías y saltos de línea uniformes para que resulte fácil de leer. JSON (JavaScript Object Notation) es el formato de datos más habitual utilizado por las API, los archivos de configuración y los sistemas de registro, pero los servidores suelen enviarlo como una sola línea larga e ilegible para ahorrar ancho de banda.
Esta herramienta también funciona como validador de JSON: analiza el texto introducido siguiendo las mismas reglas estrictas que utilizan los navegadores, por lo que, si a tu JSON le falta una coma, una clave no entre comillas o tiene una coma al final, verás el mensaje de error exacto en lugar de que se produzca un error silencioso.
JSON está definido formalmente por dos estándares alineados, el RFC 8259 y ECMA-404 — y la especificación es deliberadamente más estricta que el propio JavaScript, razón por la cual un fragmento que funciona sin problemas como código JS puede fallar aquí la validación estricta de JSON.
Consejos prácticos
- ¿Estás depurando una API? Pega primero la respuesta sin formatear y luego formatea el texto: el validador señala la línea y la columna exactas de cualquier error de sintaxis, lo cual es mucho mejor que tener que entrecerrar los ojos para leer un bloque de texto de una sola línea.
- Utiliza una sangría de 2 espacios para facilitar la lectura en pantalla y minimiza el código antes de pegar el JSON en una URL, una variable de entorno o un mensaje de chat, ya que allí los espacios en blanco solo ocupan bytes.
- Los comentarios al estilo JSON5 y las comas finales son las dos razones más habituales por las que una configuración escrita a mano «parece correcta», pero no supera la validación: el JSON estricto no permite ninguna de las dos cosas.
- En el caso de archivos muy grandes (registros, copias de seguridad de bases de datos), formatea solo el fragmento que te interese: así tu editor seguirá respondiendo con rapidez y te resultará más fácil seguir la estructura.
Cómo encaja esto en los flujos de trabajo reales
El flujo más habitual que vemos es el siguiente: una API devuelve JSON codificado en Base64 o minificado dentro de un token o de la carga útil de un webhook. Primero se decodifica el Base64, después se formatea el JSON y, por último, se comparan las dos respuestas cuando se produce algún cambio entre entornos. Para cada paso hay una herramienta específica, y tus cargas útiles nunca salen del navegador en ninguna de estas etapas.
Los desarrolladores front-end utilizan la optimización con la misma frecuencia que el formateo: ¿vas a distribuir un archivo JSON estático de gran tamaño? Optimizarlo suele suponer un ahorro del 20-30 % incluso antes de que gzip entre en acción.
→ Codificador/decodificador Base64 · Diferencias entre textos
Casos de uso habituales
- Leer una respuesta de API minificada que se devuelve como una sola línea ilegible, para comprender su estructura durante la depuración.
- Validar un archivo de configuración (como un «package.json» o un archivo de configuración basado en JSON) que, por alguna razón desconocida, la aplicación no lee correctamente.
- Compartir un fragmento de código JSON legible y bien formateado en un informe de error, una revisión de código o la documentación.
- Reducir una carga útil JSON a su forma más compacta antes de incluirla en un parámetro de URL o almacenarla en una columna de una base de datos con límites de tamaño.
Errores de sintaxis JSON más habituales
La mayoría de los errores de JSON se repiten una y otra vez. Esta tabla resume los que vemos con más frecuencia y cómo solucionarlos en cuanto el validador señale la línea.
| Error | Ejemplo incorrecto | Solución |
|---|---|---|
| Comilla simple en vez de doble | {'clave': 'valor'} | Usa siempre comillas dobles: {"clave": "valor"} |
| Clave sin comillas | {clave: "valor"} | Todas las claves deben ir entre comillas dobles: {"clave": "valor"} |
| Coma final tras el último elemento | [1, 2, 3,] | Elimina la coma antes del cierre: [1, 2, 3] |
| Comentarios dentro del JSON | {"clave": 1} // nota | JSON estricto no admite comentarios; bórralos o usa un archivo .jsonc aparte |
| Valor `undefined` o función | {"clave": undefined} | JSON solo admite null, no undefined ni funciones |
| Comas o dos puntos faltantes | {"a": 1 "b": 2} | Añade la coma entre pares: {"a": 1, "b": 2} |
¿Por qué utilizarlo?
Un endpoint te devuelve un error 500 envuelto en una sola línea de JSON ilegible: pégalo aquí y verás exactamente qué campo del payload viene mal antes de tocar una sola línea de código.
Tu compañero te pasó un archivo de configuración exportado desde Postman como un bloque comprimido: fórmatealo primero y el pull request queda legible en segundos, sin abrir el editor.
Vas a pegar un objeto JSON dentro de una URL corta o una variable de entorno de Vercel/Netlify: minifícalo aquí para no gastar caracteres de más ni arriesgarte a romper el límite del proveedor.
El JSON que estás depurando incluye tokens de API o datos de un cliente real: todo se procesa en tu navegador, así que nada sale de tu equipo solo por querer leerlo con claridad.
Un archivo de configuración de una app (o un `package.json` corrupto) deja de funcionar sin explicación: valídalo aquí y el mensaje de error señala la línea y columna exactas del problema.
Estás revisando un `webhook` de Stripe o Mercado Pago en mitad de una guardia: no hay registro ni cuenta que crear, así que puedes abrirlo desde el móvil y seguir trabajando de inmediato.
Preguntas frecuentes
¿Se suben mis datos JSON a un servidor?
No. Esta herramienta se ejecuta íntegramente en tu navegador mediante JavaScript. Tu archivo JSON nunca sale de tu dispositivo, por lo que es seguro utilizarla con datos confidenciales o internos.
¿Por qué mi JSON no es válido?
Las causas más habituales son: comas que faltan o de más, claves sin comillas dobles, comillas simples en lugar de comillas dobles, comas al final tras el último elemento y comentarios (JSON no permite comentarios). El mensaje de error que aparece debajo del cuadro de entrada te indica lo que ha detectado el analizador sintáctico.
¿Cuál es la diferencia entre «Formatear» y «Minificar»?
La opción «Formatear» añade sangrías y saltos de línea para que el JSON resulte legible para los usuarios. La opción «Minificar» elimina todos los espacios en blanco innecesarios para que el JSON ocupe el menor espacio posible, lo cual resulta útil antes de transmitirlo o incrustarlo.
¿Hay algún límite de tamaño?
La herramienta no impone ningún límite estricto. Los archivos muy grandes (de decenas de megabytes) pueden tardar más en cargarse, dependiendo de tu dispositivo, ya que todo el procesamiento se realiza de forma local en tu navegador.
¿Esto puede corregir automáticamente un JSON erróneo?
No, la herramienta te indica exactamente dónde hay un error en el JSON para que puedas corregirlo, pero no adivina ni modifica tus datos. Esto es a propósito: «corregir» los datos de forma silenciosa puede ocultar errores reales.
¿Admite este formateador JSON5 o JSONC (JSON con comentarios)?
No. Esta herramienta valida JSON estricto según el RFC 8259, el mismo que usan las API y los navegadores. JSON5 y JSONC son extensiones cómodas para archivos de configuración escritos a mano (permiten comentarios y comas finales), pero no son JSON válido, así que si tu archivo usa esa sintaxis, el validador la marcará como error — que es exactamente lo que necesitas saber antes de enviarlo a una API.
¿En qué se diferencia esto de simplemente usar `JSON.stringify` en la consola del navegador?
El resultado final del formato es parecido, pero aquí no necesitas abrir la consola de desarrollador, escribir código ni tener el archivo cargado en una página. También te da un mensaje de error legible en lugar de una excepción críptica de JavaScript, y funciona igual con archivos enormes sin bloquear una pestaña que ya tenías abierta.
¿Funciona sin conexión a internet?
Sí, una vez que la página ha cargado por completo. Todo el análisis y formateo ocurre con JavaScript en tu navegador, no hay ninguna llamada de red al formatear o minificar, así que puedes desconectarte y seguir usándolo con normalidad.
¿Por qué mi JSON válido en JavaScript falla aquí?
Porque JavaScript acepta cosas que JSON estricto no permite: comillas simples, claves sin comillas, comas finales, `undefined`, comentarios y funciones. Un objeto literal que funciona perfectamente como código JS puede fallar la validación JSON — eso no es un error de la herramienta, es la diferencia real entre ambos formatos.