Cómo formatear JSON: 3 formas fiables de embellecerlo y validarlo (Guía 2026)

Qué significa realmente “formatear JSON”

El JSON que llega de una API o de un log suele estar minificado: todo el documento comprimido en una sola línea sin espacios. Sigue siendo JSON válido, pero ilegible. Formatear (también llamado pretty-print o embellecer) lo expande de nuevo en líneas con sangría para que veas la estructura: objetos dentro de objetos, arrays de elementos y dónde termina cada uno.

A veces se confunde con validar, y suelen ir juntos. La validación responde “¿es JSON legal?”, el formateo responde “¿puede leerlo un humano?”. Los buenos formateadores hacen ambas cosas de una pasada: si tu JSON tiene un error de sintaxis, el formateador se detiene y señala la línea en lugar de producir basura en silencio.

Método 1: Formateador online gratuito (el más rápido)

Para un caso puntual — pegar una respuesta de API o un fragmento de log — una herramienta online es la vía más rápida: sin instalar nada, sin código. Elige una que funcione por completo en tu navegador (lado cliente) para que tus datos nunca salgan de tu dispositivo; esto importa si el JSON contiene tokens, correos o datos sensibles.

Pega tu JSON en el formateador (o suelta un archivo .json).
Pulsa Formatear: la herramienta aplica la sangría, colorea la sintaxis y marca los errores con su número de línea.
Copia el resultado formateado a tu editor, o usa el botón Minificar si necesitas la versión compacta para producción.

Método 2: Tu editor de código (el hábito diario)

Si trabajas con JSON a menudo, formatear dentro del editor es una pulsación de tecla. En VS Code, abre el archivo .json y pulsa Mayús+Alt+F (Windows/Linux) o Mayús+Opción+F (Mac): “Formatear documento”. VS Code también puede formatear al guardar si activas Editor: Format On Save.

La mayoría de editores necesitan un plugin para el trabajo avanzado con JSON, pero el formateo básico viene integrado en VS Code, Sublime Text (con paquetes) y los IDE de JetBrains.

Método 3: Comando de terminal (repetible)

Cuando el JSON vive en un archivo y quieres el mismo resultado siempre — en un script, un paso de despliegue o simplemente rápido en la línea de comandos — una línea de comando gana a hacer clic.

Terminal

# Mostrar data.json con formato en la terminal
python3 -m json.tool data.json

# Guardar la versión formateada en un archivo nuevo
python3 -m json.tool data.json > data.pretty.json

# La misma idea con jq, si lo tienes instalado
jq . data.json

python3 -m json.tool también valida: termina con error y número de línea cuando el archivo no es JSON válido, lo que lo convierte en una comprobación rápida dentro de scripts.

Pretty-print vs minificado: cuándo usar cada uno

El JSON con formato legible es para humanos: depurar, archivos de configuración que editas a mano, ejemplos en documentación. El JSON minificado es para máquinas: respuestas de API, archivos de producción, todo lo que requiera menos bytes y parseo rápido.

Puedes convertir entre ambos libremente — son los mismos datos. Solo evita editar a mano la versión minificada: expándela primero, haz tu cambio y vuelve a minificarla si el consumidor la necesita compacta.

Errores comunes que el formateo revela

Nueve de cada diez veces, que un formateador “falle” es lo más útil que puede hacer. Estos son los culpables que sigue encontrando:

Comas finales: {"a": 1,} es ilegal en JSON (en JavaScript vale). Elimina la coma antes del corchete de cierre.
Comillas simples: los strings JSON necesitan comillas dobles. Cambia 'valor' por "valor".
Comentarios: // y /* */ no forman parte de JSON. Elimínalos o cambia el archivo a JSONC/JSON5 si tu herramienta lo soporta.
Claves sin comillas: {nombre: "x"} necesita {"nombre": "x"}.
Daño de copiar-pegar: las comillas tipográficas de apps de chat y documentos (“ ”) no son caracteres de comilla válidos; sustitúyelas por comillas rectas.

Siguiente paso: convierte tu JSON formateado en hoja de cálculo

Una vez que tu JSON es legible y válido, el siguiente paso suele ser llevarlo a una hoja de cálculo — y eso es justo lo que hace nuestro convertidor gratuito: aplana tu JSON en un CSV limpio y listo para hojas de cálculo en segundos, con la misma privacidad sin subidas.

Leer: Cómo convertir JSON a CSV

Guías relacionadas

Preguntas frecuentes

¿Formatear es lo mismo que validar JSON?

No, pero se solapan. La validación comprueba si tu JSON cumple las reglas de sintaxis; el formateo lo reescribe con sangría y saltos de línea para que los humanos lo lean. La mayoría de formateadores validan primero: no formatean un documento con error de sintaxis, por eso un formateo fallido suele significar JSON inválido.

¿Formatear cambia mis datos?

No. Formatear solo cambia los espacios en blanco: sangría, saltos de línea y espacios. Claves, valores, orden y tipos quedan exactamente igual — salvo que actives extras como ordenar claves, que algunas herramientas ofrecen como opción aparte.

¿Qué significa “Unexpected token” al formatear JSON?

Significa que el parser encontró un carácter que no puede colocar: casi siempre una coma final, un string entre comillas simples, una clave sin comillas o una comilla tipográfica pegada desde una app de chat. El mensaje de error suele incluir una posición; corrige ese punto, formatea de nuevo y aparecerá el siguiente error (si lo hay).

¿Puedo formatear JSON sin instalar nada?

Sí. Usa un formateador online gratuito que funcione en tu navegador, o la línea python3 -m json.tool si ya tienes Python en tu máquina. VS Code también formatea archivos .json de serie con Mayús+Alt+F.

¿Es seguro pegar JSON en un formateador online?

Normalmente sí, pero elige uno que procese todo en tu navegador (lado cliente): así nada se sube a ningún servidor. Si el JSON contiene claves de API, datos personales o algo que no enviarías por correo, usa tu editor o el comando de terminal.

¿Qué es el JSON minificado?

JSON con todo el espacio en blanco innecesario eliminado: todo el documento en una sola línea. Las APIs y los archivos de producción lo usan porque ocupa menos y se parsea algo más rápido. Es JSON válido, solo que no está pensado para ojos humanos. Cualquier formateador puede expandirlo a la versión legible.

¿El formateo funciona con archivos JSON enormes?

Sí, con límites. Los formateadores de navegador manejan bien unos pocos megabytes; más allá pueden congelar la pestaña. Para archivos grandes, formatea en local con python3 -m json.tool o jq, que procesan archivos grandes sin despeinarse.