Cómo formatear JSON: La guía completa para desarrolladores

JSON (JavaScript Object Notation) es el lenguaje universal del intercambio de datos en la web. Ya sea que estés construyendo una API REST, configurando una aplicación o transfiriendo datos entre servicios, trabajarás con JSON constantemente. Pero el JSON en bruto puede ser difícil de leer, e incluso pequeños errores de sintaxis pueden romper toda tu aplicación.

Esta guía cubre todo lo que necesitas saber sobre el formateo JSON — desde la estructura básica hasta consejos avanzados y errores comunes.

¿Qué es JSON?

JSON es un formato de datos ligero, basado en texto, fácil de leer para humanos y de procesar para máquinas. Se basa en dos estructuras:

• Pares clave-valor (objetos): { "nombre": "Alice", "edad": 30 }
• Listas ordenadas (arrays): [1, 2, 3, "cuatro"]

Estas se pueden anidar para crear estructuras de datos complejas:

{
  "usuario": {
    "nombre": "Alice",
    "roles": ["admin", "editor"],
    "configuracion": {
      "tema": "oscuro",
      "notificaciones": true
    }
  }
}

¿Por qué formatear JSON?

Cuando el JSON está minificado (sin espacios), se vuelve casi imposible de leer:

{"usuario":{"nombre":"Alice","roles":["admin","editor"],"configuracion":{"tema":"oscuro","notificaciones":true}}}

El formateo (también llamado «embellecer» o «pretty-print») añade sangrías y saltos de línea para hacer visible la estructura:

{
  "usuario": {
    "nombre": "Alice",
    "roles": [
      "admin",
      "editor"
    ],
    "configuracion": {
      "tema": "oscuro",
      "notificaciones": true
    }
  }
}

El JSON formateado es esencial para:

• Depurar respuestas de API: Detectar rápidamente campos faltantes o valores inesperados.
• Revisiones de código: Hacer los archivos de configuración legibles para tu equipo.
• Documentación: Incluir ejemplos JSON claros en tu documentación.
• Edición manual: Encontrar y corregir errores sin perder la cabeza.

Buenas prácticas de formateo JSON

1. Usa sangría consistente

El estándar es 2 espacios o 4 espacios por nivel. Elige uno y manténlo en todo tu proyecto. La mayoría de las guías de estilo (incluidas las de Google y Airbnb) recomiendan 2 espacios.

2. Siempre pon las claves entre comillas dobles

JSON requiere comillas dobles alrededor de todas las claves de objeto. Este es un error común al venir de JavaScript:

// ❌ JSON inválido
{ nombre: "Alice" }

// ✅ JSON válido
{ "nombre": "Alice" }

3. Usa comillas dobles para las cadenas

Las cadenas JSON deben usar comillas dobles, no simples:

// ❌ Inválido
{ 'nombre': 'Alice' }

// ✅ Válido
{ "nombre": "Alice" }

4. Sin comas finales

A diferencia de JavaScript, JSON no permite comas finales:

// ❌ Inválido
{ "nombre": "Alice", "edad": 30, }

// ✅ Válido
{ "nombre": "Alice", "edad": 30 }

5. Solo tipos de datos válidos

JSON admite exactamente seis tipos de datos:

Tipo	Ejemplo
String	"hola"
Number	42, 3.14
Boolean	true, false
Null	null
Object	{ "clave": "valor" }
Array	[1, 2, 3]

No existe undefined, Date, function ni Symbol en JSON.

Cómo formatear JSON programáticamente

JavaScript

const data = { nombre: "Alice", edad: 30 };
const formateado = JSON.stringify(data, null, 2);
console.log(formateado);

El tercer parámetro (2) establece la sangría en 2 espacios.

Python

import json
data = {"nombre": "Alice", "edad": 30}
formateado = json.dumps(data, indent=2, ensure_ascii=False)
print(formateado)

Línea de comandos (jq)

echo '{"nombre":"Alice"}' | jq .

Errores comunes de JSON y cómo corregirlos

Error	Causa	Solución
Unexpected token '	Comillas simples en vez de dobles	Reemplazar ' con "
Unexpected end of JSON input	Datos truncados o vacíos	Verificar que el JSON esté completo
Unexpected token ,	Coma final	Eliminar la última coma
Unexpected token u	undefined en los datos	Reemplazar con null o eliminar la clave

Valida antes de formatear

El formateo no corrige JSON inválido. Si tu JSON tiene errores de sintaxis, un formateador puede producir resultados inesperados o fallar. Siempre valida tu JSON primero, luego formatealo.

Un buen formateador validará y embellecerá tu JSON en un solo paso, resaltando errores con números de línea y descripciones claras.

Prueba nuestro formateador JSON gratuito

Nuestro Formateador JSON se encarga de todo por ti. Pega tu JSON, y hará:

• Detectar y corregir automáticamente problemas de formato comunes
• Embellecer tu JSON con sangría configurable
• Validar la sintaxis y resaltar errores
• Funcionar completamente en tu navegador — tus datos nunca salen de tu dispositivo

Ya sea que estés depurando una respuesta de API complicada, limpiando un archivo de configuración o preparando JSON para documentación, nuestro formateador lo hace instantáneo y sin errores.

JSON vs XML vs YAML

Si estás eligiendo un formato de datos para tu proyecto, aquí tienes una comparación rápida:

Criterio	JSON	XML	YAML
Legibilidad	Buena	Verboso	Excelente
Tamaño de archivo	Pequeño	Grande	Medio
Velocidad de análisis	Rápido	Lento	Medio
Tipos de datos	Limitados	Ninguno (todo strings)	Rico
Comentarios	No soportados	Soportados	Soportados

JSON sigue siendo la mejor opción para APIs e intercambio de datos web gracias a su equilibrio entre simplicidad, velocidad y soporte universal.

Conclusión

Un JSON correctamente formateado ahorra tiempo, reduce errores y hace tu código más mantenible. Sigue las buenas prácticas anteriores, valida antes de formatear y usa las herramientas adecuadas para acelerar tu flujo de trabajo.

Prueba el Formateador JSON ahora — pega tu JSON y ve la diferencia que el formateo hace en segundos.