Herramientas · Software

Formateador y minificador de JSON

Pegue un JSON para darle formato legible, minificarlo u ordenar sus claves. La herramienta conserva cada número y cada cadena tal como están escritos, señala la línea y la columna de cualquier error y trabaja en su navegador: sus datos no se envían a ningún servidor.

JSON de entrada

También puede abrir un archivo .json (hasta 10 MB). Nada se envía a ningún servidor.

Resultado

Pegue un JSON a la izquierda o cargue el ejemplo para ver el resultado.

Estas herramientas se ejecutan en su navegador y no envían lo que usted escribe a nuestros servidores. Aun así, evite pegar secretos reales (contraseñas, claves privadas, tokens de producción) en cualquier sitio web. Consulte los Términos de uso.

Qué es JSON y por qué conviene darle formato

JSON (JavaScript Object Notation) es el formato de texto más usado para intercambiar datos entre aplicaciones: las API web, los archivos de configuración, las bases de datos documentales y los registros de eventos lo emplean a diario. Está definido en el estándar RFC 8259 (y en ECMA-404) y solo admite seis tipos de valor: objetos { }, arreglos [ ], cadenas entre comillas dobles, números, true/false y null.

Las máquinas leen JSON sin importar los espacios, así que los servicios suelen enviarlo minificado, en una sola línea, para ahorrar ancho de banda. Eso lo vuelve ilegible para las personas. Dar formato (pretty print) añade saltos de línea y sangría para que la estructura se vea de un vistazo, y minificar hace el camino inverso antes de guardar o transmitir.

Cómo usar el formateador

  1. Pegue el JSON en el cuadro de entrada, o use Abrir archivo… para cargar un .json de hasta 10 MB.
  2. Elija la acción: Formatear (legible) o Minificar (compacto), y la sangría que prefiera.
  3. Active Ordenar las claves si quiere una salida estable, por ejemplo, para comparar dos documentos.
  4. Copie el resultado o descárguelo como archivo. Si el texto tiene un error, verá la línea, la columna y cómo corregirlo.

Qué hace distinta a esta herramienta

  • No altera sus valores. Muchos formateadores leen el JSON con JSON.parse y lo vuelven a escribir, lo que cambia silenciosamente números como 12345678901234567890 (se convierte en 12345678901234567000), 1.0 (pasa a 1) o 1E5 (pasa a 100000). Aquí cada número y cada cadena se copian tal como están escritos; solo cambian los espacios.
  • Errores con línea y columna. Si el texto no es JSON válido, se indica dónde y por qué, con una pista de corrección, en lugar de un genérico «Unexpected token».
  • Avisos útiles. Detecta claves duplicadas dentro de un objeto y números que un programa en JavaScript leería con pérdida de precisión.
  • Privacidad. El análisis ocurre en su navegador. Puede usarlo con datos de trabajo sin que salgan de su equipo.

Formatear, minificar y ordenar claves

OpciónQué haceCuándo usarla
FormatearUn valor por línea, con sangría según el nivel de anidamiento; los objetos y arreglos vacíos quedan en una línea ({}, []).Leer, depurar y revisar respuestas de una API o archivos de configuración.
MinificarElimina todo espacio y salto de línea que no forme parte de una cadena.Reducir el tamaño antes de transmitir, incrustar en una variable o guardar en una base de datos.
Sangría de 2 espaciosEl estilo más habitual en JavaScript, TypeScript y la mayoría de herramientas web.Opción por defecto.
Sangría de 4 espaciosMás separación visual en cada nivel.Proyectos en Java, PHP, Python o C#, donde 4 espacios es la norma.
TabulaciónUn carácter de tabulación por nivel; cada persona la ve con el ancho que configure en su editor.Equipos que prefieren tabulaciones por accesibilidad.
Ordenar clavesOrdena alfabéticamente las claves de cada objeto (por valor de código, de modo que las mayúsculas van antes que las minúsculas). El orden de los arreglos no cambia.Comparar dos JSON con una herramienta de diferencias, o producir salidas estables en control de versiones.

Ordenar las claves no cambia el significado del documento, porque en un objeto JSON el orden de los miembros no es significativo. Los arreglos sí conservan su orden, que forma parte de los datos.

Ejemplo

Este JSON minificado:

{"nombre":"Karven","activo":true,"version":2.0,"modulos":["json","sql"],"config":{"tema":"oscuro","limite":100,"vacio":{}}}

queda así con sangría de 2 espacios (observe que 2.0 se conserva tal como se escribió):

{
  "nombre": "Karven",
  "activo": true,
  "version": 2.0,
  "modulos": [
    "json",
    "sql"
  ],
  "config": {
    "tema": "oscuro",
    "limite": 100,
    "vacio": {}
  }
}

Con Ordenar las claves activado, las propiedades de cada objeto aparecen en orden alfabético (activo, config, modulos, nombre, version):

{
  "activo": true,
  "config": {
    "limite": 100,
    "tema": "oscuro",
    "vacio": {}
  },
  "modulos": [
    "json",
    "sql"
  ],
  "nombre": "Karven",
  "version": 2.0
}

Y al minificar el resultado se recupera la forma compacta, sin ningún espacio de más:

{"nombre":"Karven","activo":true,"version":2.0,"modulos":["json","sql"],"config":{"tema":"oscuro","limite":100,"vacio":{}}}

Cómo leer un JSON formateado

  • Cada objeto empieza con { y termina con }; contiene pares "clave": valor separados por comas.
  • Cada arreglo empieza con [ y termina con ]; contiene valores separados por comas, en un orden que importa.
  • La sangría crece un nivel por cada objeto o arreglo abierto: si una línea está muy a la derecha, está muy anidada. La profundidad máxima del resultado le dice cuántos niveles tiene el documento.
  • Las cadenas siempre usan comillas dobles; los números no llevan comillas; true, false y null se escriben en minúsculas y sin comillas.

Buenas prácticas con JSON

  • Fechas como texto ISO 8601 ("2025-03-15T10:30:00Z"): JSON no tiene un tipo de fecha y este formato se ordena y se interpreta sin ambigüedad.
  • Identificadores grandes como cadenas. Los enteros de más de 15 dígitos (por ejemplo, los identificadores de 64 bits) no caben en un número de JavaScript sin perder precisión; guárdelos entre comillas.
  • Claves coherentes. Elija un estilo (camelCase o snake_case) y úselo en todo el documento.
  • Sin comentarios ni comas finales. JSON los prohíbe. Si necesita comentar un archivo de configuración, considere formatos hechos para ello, como JSONC, JSON5, YAML o TOML.
  • Codificación UTF-8 sin BOM. Es la que esperan casi todos los analizadores.
  • No guarde secretos en texto plano (contraseñas, claves de API) en archivos JSON versionados.

Para comprobar la sintaxis con más detalle (estadísticas de la estructura, claves duplicadas y ubicación exacta de los errores), use el validador JSON. Si recibe un token con tres partes separadas por puntos, es un JWT y su contenido se decodifica con otra herramienta.

Preguntas frecuentes

¿Se envía mi JSON a algún servidor?

No. El formateo se hace en su navegador con JavaScript; lo que pega o carga no sale de su equipo, ni siquiera cuando usa archivos grandes.

¿Por qué esta herramienta no cambia los números?

Porque no vuelve a escribir los valores: solo reorganiza los espacios alrededor de ellos. Así 1.0 sigue siendo 1.0 y un identificador de 20 dígitos no se redondea, algo que sí ocurre en herramientas que usan JSON.parse y JSON.stringify.

¿Qué diferencia hay entre formatear y minificar?

Formatear añade saltos de línea y sangría para que una persona lo lea; minificar los quita para que ocupe lo menos posible. Ambos describen exactamente los mismos datos.

¿Ordenar las claves cambia el significado del JSON?

No. El orden de los miembros de un objeto no es significativo, de modo que el documento ordenado equivale al original. Los arreglos nunca se reordenan, porque su orden sí forma parte de los datos.

¿Puede formatear archivos grandes?

Sí, hasta unos 10 MB en el navegador. Un archivo de unos 6 MB se procesa en menos de un segundo en un equipo actual; con textos muy grandes, el cuadro de texto puede ir más lento al desplazarse.

¿Por qué dice que mi JSON no es válido si funciona en mi programa?

Algunos lenguajes y bibliotecas aceptan extensiones que el estándar no permite: comentarios, comas finales, comillas simples o claves sin comillas. Si el programa que lo lee es tolerante, funcionará allí pero fallará en un analizador estricto. La herramienta le indica qué línea corregir.