Cómo formatear y validar JSON (y corregir los 7 errores más comunes)

JSON en 30 segundos

JSON (JavaScript Object Notation) es el formato de datos más usado en la web: respuestas de API, archivos de configuración (package.json, tsconfig.json), exportaciones de datos, logs. Se basa en unos pocos elementos:

{
  "nombre": "AwesomeToolkit",
  "herramientas": 90,
  "gratis": true,
  "idiomas": ["en", "fr", "es"],
  "propietario": null
}

Objetos entre llaves, arrays entre corchetes, cadenas entre comillas dobles, números, true, false y null. Nada más. Y aun así, una sola coma mal puesta basta para romperlo todo.

Formatear, validar, minificar: ¿qué diferencia hay?

Operación	Qué hace	Cuándo usarla
Formatear (indentar)	Añade sangría y saltos de línea	Leer una respuesta de API, depurar
Validar	Comprueba la sintaxis y localiza errores	Antes de hacer commit de una config, tras editar a mano
Minificar	Quita todos los espacios innecesarios	Producción, transferencia por red, incrustarlo en una URL o variable

Formatea JSON online

El formateador JSON hace las tres cosas en tu navegador: puedes pegar JSON con tokens, datos de clientes o configuraciones sin que se envíe a ningún sitio.

• Pega tu JSON: se indenta y se resalta.
• Elige la sangría: 2 espacios, 4 espacios o tabulador.
• Si hay un error, la herramienta muestra la línea y la columna exactas y explica el problema.
• Los números muy grandes (más allá de 2^53, como algunos identificadores) se conservan tal como están escritos, mientras que muchas herramientas los redondean sin avisar.
• Las claves duplicadas — válidas en teoría, pero fuente clásica de bugs — se señalan.

Los 7 errores de JSON más comunes

1. La coma final

{ "a": 1, "b": 2, }

JavaScript la acepta, JSON no. Quita la última coma.

2. Las comillas simples

{ 'nombre': 'Alicia' }

JSON solo acepta comillas dobles, tanto en claves como en cadenas.

3. Claves sin comillas

{ nombre: "Alicia" }

Válido en JavaScript, no en JSON: cada clave debe ir entre comillas dobles.

4. Los comentarios

{ "port": 8080 // puerto de desarrollo }

El JSON estándar no admite comentarios. Algunas herramientas los aceptan (JSONC, que usa VS Code), pero una API no.

5. Falta una coma entre dos elementos

Suele pasar tras copiar y pegar: el error se señala al principio del elemento siguiente, no al final del anterior.

6. Caracteres especiales sin escapar

Un salto de línea o unas comillas dentro de una cadena deben escaparse: \n, \". Las rutas de Windows necesitan barras invertidas dobles: "C:\\Users\\archivo.txt".

7. Valores no válidos

undefined, NaN, Infinity y fechas como new Date() no existen en JSON. Usa null, un número o una cadena ISO ("2026-07-09T10:00:00Z").

Para ir más lejos

• Convierte JSON a YAML (Kubernetes, GitHub Actions, Docker Compose) con el conversor JSON ↔ YAML.
• Convierte un array JSON en hoja de cálculo con el conversor JSON ↔ CSV.
• Genera tipos TypeScript a partir de una respuesta de API con JSON a TypeScript.
• Inspecciona un JWT, cuyo contenido es JSON codificado en Base64URL, con el decodificador JWT.

Conclusión

Un formateador JSON es una de esas pequeñas herramientas que usas diez veces al día sin pensarlo. Formatea para leer, valida antes de hacer commit, minifica para producción — y cuando el analizador se queja, el error casi siempre es uno de los siete anteriores.