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… | Usa | Lo que obtienes |
|---|---|---|
| Leer o editar un documento desordenado o de una sola línea | Formateador en modo Formatear | JSON con sangría y saltos de línea |
| Saber si un archivo es válido y dónde falla | Validador | Una lista de errores con línea, columna y un indicador |
| Reducir el JSON antes de enviarlo o guardarlo | Minificador o Minificar en el formateador | Una sola línea compacta, con los mismos datos |
| Hacer comparables dos exportaciones | Ordenar claves | El 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
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.
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.
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.
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.
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 JSONLos 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.
| Error | Ejemplo | Solució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 JavaScript | True, False, None, NaN, undefined | Usa true, false y null; JSON no tiene NaN |
| Salto de línea real dentro de una cadena | Un salto de línea de verdad entre comillas | Escrí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ía | Ideal para | Contrapartida |
|---|---|---|
| 2 espacios | Proyectos web, archivos de configuración, la mayoría de la documentación de APIs | Compacto; los datos muy anidados pueden seguir siendo difíciles de seguir |
| 4 espacios | Leer datos muy anidados, material didáctico | Líneas más anchas; más desplazamiento horizontal |
| Tabulador | Equipos cuya guía de estilo usa tabuladores | El ancho depende del visor, así que se ve distinto en cada editor |
| Minificar | Enviar, guardar o incrustar | El 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
- 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.
- 2Revisa las comillas: cada clave y cada cadena debe usar comillas dobles rectas, no simples ni tipográficas.
- 3Busca una coma al final del último elemento de un objeto o lista, y una coma que falte entre dos elementos.
- 4Busca comentarios, True, False, None, NaN y undefined, y sustitúyelos por JSON válido.
- 5Comprueba que cada llave o corchete de apertura tiene su pareja y que el documento es un único valor, no dos pegados juntos.
- 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.