IA en tu dispositivo: profesional y privado.

Documentos

Cómo formatear JSON online (y corregir los errores que lo rompen)

Pega un JSON desordenado y obtén uno legible y con sangría. Corrige comas finales, comillas simples, claves sin comillas y comentarios; elige la sangría.

Actualizado el 1 de noviembre de 20269 min de lectura

Para formatear JSON, pégalo en el formateador de JSON, elige una sangría de 2 espacios, 4 espacios o tabulador y pulsa Formatear JSON. Una sola línea ilegible se convierte en un esquema con sangría que se lee sin esfuerzo, y si el JSON está roto recibes la línea y la columna del problema en lugar de un fallo vago. La misma página minifica, ordena claves y repara los errores más habituales. Esta guía explica qué cambia y qué no cambia el formateo, cómo corregir cada error de sintaxis frecuente, qué sangría elegir y qué esperar con archivos grandes.

¿Formatear, validar o minificar?

Quieres…UsaLo que obtienes
Leer o editar un documento desordenado o de una sola líneaFormateador en modo FormatearJSON con sangría y saltos de línea
Saber si un archivo es válido y dónde fallaValidadorUna lista de errores con línea, columna y un indicador
Reducir el JSON antes de enviarlo o guardarloMinificador o Minificar en el formateadorUna sola línea compacta, con los mismos datos
Hacer comparables dos exportacionesOrdenar clavesEl mismo orden de claves siempre

Las tres tareas comparten una regla: los datos siguen siendo exactamente los mismos y solo cambia el espacio en blanco a su alrededor. Formatear añade saltos de línea y sangría, minificar los quita y validar lee el documento sin modificarlo en absoluto.

Formatear JSON, paso a paso

1

Pega o añade el JSON

Abre el formateador de JSON. Suelta un archivo .json, .jsonc, .ndjson, .jsonl o .txt en la página, elige uno con Examinar archivos o abre el panel de pegado y pega directamente desde el portapapeles.

2

Elige Formatear y una sangría

En Salida elige Formatear para obtener JSON legible. En Sangría elige 2 espacios, 4 espacios o Tabulador. Todo lo de este panel es gratis.

3

Lee el resultado

La vista Texto muestra la salida resaltada. Árbol permite contraer ramas y copiar la ruta de cualquier valor, y Datos informa de la profundidad y del número de objetos, listas, cadenas y números.

4

Corrige los errores, si los hay

Un documento roto muestra un mensaje, una línea, una columna y la línea afectada con un indicador bajo el carácter. Si es un problema que la herramienta sabe reparar, marca Reparar JSON inválido y te lista cada cambio que hizo.

5

Copia o descarga

Pulsa Copiar para el portapapeles o Descargar para un archivo. No se envía nada a un servidor; todo se ejecuta en tu dispositivo.

Formatea con sangría, minifica, ordena claves y repara JSON roto, con todas las opciones de formato incluidas. Gratis: un archivo de hasta 25 MB. Pro: hasta 20 archivos a la vez, descargados en un solo ZIP. Todo se ejecuta en tu dispositivo, no en nuestros servidores.

Formatear JSON

Los errores de sintaxis que rompen el JSON y cómo corregir cada uno

JSON es más estricto que el JavaScript al que se parece. La mayoría de los fallos vienen de costumbres traídas del código, de archivos de configuración o de la salida de Python. Aquí están, más o menos por orden de frecuencia.

ErrorEjemploSolución
Coma final{"a": 1,}Borra la coma antes de la llave o el corchete de cierre
Comillas simples{'a': 'b'}Usa comillas dobles para claves y cadenas
Claves sin comillas{a: 1}Pon cada clave entre comillas dobles: {"a": 1}
Comentarios// nota o /* nota */Quítalos; JSON no tiene sintaxis de comentarios
Valores de Python o JavaScriptTrue, False, None, NaN, undefinedUsa true, false y null; JSON no tiene NaN
Salto de línea real dentro de una cadenaUn salto de línea de verdad entre comillasEscríbelo como \n dentro de la cadena
Coma que falta{"a": 1 "b": 2}Añade una coma entre los miembros

Para los cinco primeros no hace falta editar a mano. Marca Reparar JSON inválido y pulsa Reparar y formatear. La reparación está desactivada por defecto porque es una decisión sobre tus datos: cuando está activa, la vista Datos lista cada cambio, por ejemplo cuántas comas finales quitó o cuántas cadenas pasó de comillas simples a dobles, para que compruebes que estás de acuerdo antes de descargar. No toca el interior de tus cadenas, así que una coma o una comilla dentro de un valor entrecomillado nunca se confunde con la estructura.

Si prefieres ver todos los problemas antes de cambiar nada, el validador de JSON sigue después del primer fallo e informa de cada uno con su línea y su columna. Un analizador normal se detiene en el primero, así que un archivo con cuarenta errores te obliga a cuarenta rondas de corrección.

Cómo elegir la sangría

La sangría solo cambia el espacio en blanco, nunca los datos, así que la elección depende de quién va a leer el archivo. Minificar no tiene sangría alguna, por lo que el control Sangría se desactiva mientras Minificar está seleccionado.

SangríaIdeal paraContrapartida
2 espaciosProyectos web, archivos de configuración, la mayoría de la documentación de APIsCompacto; los datos muy anidados pueden seguir siendo difíciles de seguir
4 espaciosLeer datos muy anidados, material didácticoLíneas más anchas; más desplazamiento horizontal
TabuladorEquipos cuya guía de estilo usa tabuladoresEl ancho depende del visor, así que se ve distinto en cada editor
MinificarEnviar, guardar o incrustarEl tamaño más pequeño; ilegible sin un formateador

Si el archivo vive en un repositorio, sigue lo que use el resto del proyecto para que un reformateo no convierta cada línea en un cambio. En Final de línea, elige LF para el control de versiones y CRLF solo para archivos que se abrirán en el Bloc de notas de Windows.

Ordenar claves, duplicados y números largos

Muchos formateadores online leen tu JSON como valores de programa y lo escriben de nuevo. Ese viaje de ida y vuelta puede alterar los datos sin avisar: un entero mayor que 9.007.199.254.740.991 se redondea, de modo que un identificador como 12345678901234567890 vuelve convertido en otro número, y una clave repetida conserva solo su último valor. Este formateador copia cada número, cadena y clave de tu texto original carácter por carácter y cambia únicamente los espacios, de modo que los identificadores largos, los ceros finales y el orden de las claves se conservan. La vista Datos incluso te dice cuántos números habrían perdido precisión en un formateador normal.

Ordenar claves ofrece No, A → Z, Z → A y Natural. El orden natural trata las series de dígitos como números, así que item2 va antes que item10. La ordenación es recursiva por los objetos anidados, y las listas conservan siempre su orden, porque el orden de una lista es información. Ordena antes de comparar dos exportaciones y las diferencias que veas serán cambios reales de valor. Para una comparación lado a lado usa la comparación de JSON. Claves duplicadas viene en Mantener ambas, la única opción que no borra nada; Mantener la primera y Mantener la última sirven para resolverlas a propósito.

Archivos grandes

El plan gratuito admite un archivo de hasta 25 MB, lo que cubre casi cualquier respuesta de API, archivo de configuración o exportación. El formateo se ejecuta en segundo plano para que la página siga respondiendo, y en documentos muy grandes la vista previa muestra la primera parte mientras la descarga contiene todo. La salida con sangría ocupa más que la entrada, porque cada nivel añade espacios. Formatear una carga de API con 2 espacios puede dejarla casi al doble de tamaño, así que un archivo de 20 MB puede producir un resultado muy por encima de 30 MB.

Si un documento está muy anidado, la sangría puede crecer muy rápido y la herramienta te avisará de que el resultado con sangría sería demasiado grande para generarlo. En ese caso elige Minificar. Cuando solo necesitas localizar algo en una respuesta enorme, la vista Árbol contrae las ramas para que quepa en una pantalla, y el visor de JSON está pensado para explorar documentos grandes. Pro eleva el límite por archivo a lo que soporte tu dispositivo y permite hasta 20 archivos de una vez.

Archivos con un registro por línea

Los registros y las exportaciones de bases de datos suelen ser JSON Lines, también llamado NDJSON: un valor JSON completo por línea, sin lista envolvente y sin comas entre registros. Un formateador normal lo da por inválido porque hay contenido después del primer registro. Este lo detecta. Por defecto cada registro se mantiene minificado en su propia línea para que el archivo siga siendo JSON Lines válido. Si necesitas un solo documento, cambia JSON Lines a Un solo array y los registros se agrupan en una sola lista con la sangría que hayas elegido.

Lista de comprobación cuando el JSON no se analiza

  1. 1Lee la línea y la columna del error y mira también el carácter anterior; muchos errores se señalan donde el analizador los notó, no donde los cometiste.
  2. 2Revisa las comillas: cada clave y cada cadena debe usar comillas dobles rectas, no simples ni tipográficas.
  3. 3Busca una coma al final del último elemento de un objeto o lista, y una coma que falte entre dos elementos.
  4. 4Busca comentarios, True, False, None, NaN y undefined, y sustitúyelos por JSON válido.
  5. 5Comprueba que cada llave o corchete de apertura tiene su pareja y que el documento es un único valor, no dos pegados juntos.
  6. 6Si el JSON venía dentro de una cadena con una barra invertida delante de cada comilla, está escapado; usa la herramienta de escape de JSON para desescaparlo primero.

Preguntas frecuentes

¿Cómo formateo JSON online gratis?

Pega tu JSON en el formateador o suelta un archivo, elige Formatear y una sangría de 2 espacios, 4 espacios o tabulador, y pulsa Formatear JSON. Todas las opciones de formato son gratuitas en archivos de hasta 25 MB, y puedes copiar o descargar el resultado.

¿Cómo corrijo un JSON inválido?

Lee la línea y la columna del mensaje de error. Las causas habituales son comas finales, comillas simples, claves sin comillas, comentarios y valores de Python como True o None. Marca Reparar JSON inválido para corregirlos automáticamente; la herramienta lista cada cambio para que lo compruebes.

¿Cuál es la diferencia entre formatear y validar JSON?

Formatear reescribe el espacio en blanco para que el documento sea fácil de leer. Validar solo comprueba si el documento es válido e informa de cada error con su posición. El formateador también muestra un error de sintaxis cuando no puede leer el archivo; el validador es mejor cuando quieres la lista completa de fallos.

¿Formatear cambia mis datos?

No. Solo cambian los espacios, los tabuladores y los saltos de línea. Los números, las cadenas y el orden de las claves se copian exactamente de tu texto, incluidos los enteros muy largos y números como 1.10, que no se redondean ni se reescriben.

¿Debo usar 2 espacios, 4 espacios o tabuladores?

Usa lo que use el resto de tu proyecto. Dos espacios es lo habitual en proyectos web y mantiene las líneas cortas, cuatro espacios se lee mejor con datos muy anidados y los tabuladores convienen a los equipos que los prefieren. La elección nunca afecta a los datos.

¿Puedo formatear un archivo JSON muy grande?

Sí. El plan gratuito admite un archivo de hasta 25 MB. Pro eleva el límite por archivo a lo que soporte tu dispositivo y formatea hasta 20 archivos a la vez en un ZIP. Si la sangría hiciera el resultado demasiado grande, usa Minificar.

Sigue leyendo

Más sobre Documentos →