Cómo formatear y validar JSON

JSON (JavaScript Object Notation) es el formato dominante para respuestas de API, archivos de configuración e intercambio de datos. Es legible y fácil de procesar, pero una coma mal puesta o una comilla que falta lo detiene todo.

Estructura básica de JSON

JSON se construye a partir de dos primitivos: objetos (pares clave-valor) y arrays (listas ordenadas). Las claves deben ser siempre cadenas entre comillas dobles. Los valores pueden ser cadenas, números, booleanos (true/false), null, objetos anidados o arrays.

{
  "nombre": "Alicia",
  "edad": 30,
  "activo": true,
  "puntuaciones": [95, 87, 92],
  "direccion": {
    "ciudad": "Madrid",
    "cp": "28001"
  }
}

Errores de sintaxis más frecuentes

• Coma final: una coma después del último elemento de un objeto o array no está permitida en JSON (a diferencia de JavaScript).
• Comillas simples: JSON exige comillas dobles tanto en claves como en valores de texto. Las comillas simples provocan un error de análisis.
• Claves sin comillas: todas las claves deben ser cadenas entre comillas — los identificadores sin comillas como { nombre: "Alicia" } no son JSON válido.
• Coma faltante: olvidar la coma entre dos elementos es el error de copiar-pegar más habitual.
• Comentarios: JSON no admite comentarios. Si los necesitas, usa JSON5 o guárdalos en una clave aparte.

Cómo formatear JSON en línea

1. Abre la herramienta Formateador JSON.
2. Pega tu JSON crudo o minificado en el área de entrada.
3. Haz clic en Formatear para aplicar una indentación legible.
4. Cualquier error de sintaxis se mostrará: corrígelo y vuelve a formatear.
5. Copia el resultado formateado o haz clic en Minificar para obtener una versión compacta en una sola línea.

Cuándo minificar JSON

El JSON minificado elimina todos los espacios en blanco y saltos de línea, reduciendo el tamaño del payload. Úsalo en respuestas de API en producción y en archivos de configuración desplegados en servidores. Guarda siempre la versión formateada en el repositorio de código fuente para facilitar la lectura.

JSON vs. YAML vs. CSV

• JSON: ideal para respuestas de API y datos anidados. Compatible con todos los lenguajes y frameworks.
• YAML: más amigable para humanos, usado en archivos de configuración (Docker Compose, GitHub Actions, Kubernetes). Sensible a la indentación.
• CSV: perfecto para datos tabulares planos: hojas de cálculo, exportaciones de bases de datos y listas simples.