PK Systems PK Systems
Herramientas para devs

Conversor JSON ↔ CSV

Convierte un array JSON en CSV limpio (o al revés). Elige el delimitador, aplana objetos anidados con notación por punto, controla la cabecera.

Conversor JSON ↔ CSV

Salida

La salida aparece aquí según escribes o pegas.

Qué hace este conversor

JSON y CSV son los dos formatos que más viajan entre APIs, hojas de cálculo, jobs de ETL y dashboards. JSON conserva tipos y anidamiento; CSV es plano y se lleva bien con Excel, Google Sheets, herramientas de BI y la mayoría de los almacenes de datos. Este conversor va en ambos sentidos. JSON a CSV toma un array de objetos y emite una fila por objeto, con una cabecera formada por la unión de todas las claves vistas. Los objetos anidados se aplanan con notación por punto (user.city), así que no se pierde información. Los arrays se vuelcan, por defecto, como su representación JSON dentro de la celda. CSV a JSON hace el camino contrario: parsea campos entre comillas estilo RFC 4180 (con dobles comillas escapadas y saltos de línea internos), convierte true, false, null y números puros a sus tipos JSON correspondientes y reconstruye objetos anidados a partir de claves con puntos en la cabecera. Toda la conversión corre localmente en tu dispositivo — tus datos nunca salen del navegador, nunca llegan a nuestros servidores y no se almacenan, indexan, registran ni comparten. Esa garantía de privacidad importa para el tipo de datos que suelen pasar por un conversor: respuestas de API con PII, exportaciones de clientes, métricas internas, cualquier cosa que venga de una base de datos de producción.

Cómo usarlo

Elige sentido, elige delimitador, pega tus datos, y la salida se actualiza al vuelo.

  1. Elige el sentido — Usa JSON → CSV cuando tienes una respuesta de API o un export y quieres una hoja de cálculo. Usa CSV → JSON cuando exportaste una tabla de Excel, Sheets o una base de datos y necesitas datos estructurados.
  2. Elige el delimitador — La coma es el valor universal. Usa punto y coma para CSVs de Excel europeo, Tab para datos del portapapeles de Excel/Sheets o pipe para logs en los que las comas ya aparecen en los datos.
  3. Decide sobre el aplanado — Deja Aplanar objetos anidados activado si tu JSON tiene datos anidados — obtendrás columnas como address.city y address.zip. Desactívalo si prefieres dejar el objeto anidado como cadena JSON dentro de una celda.
  4. Copia o pega de vuelta — Usa el botón de copia para llevar el resultado al portapapeles. CSV se pega directo en Excel, Sheets o un editor; JSON se pega en Postman, en tu IDE o donde sea que se espere un cuerpo JSON.

Reglas de escapado y comillas

CSV no tiene una especificación oficial única, pero la RFC 4180 captura el consenso que sigue cualquier parser moderno. Un campo va entre comillas dobles si y solo si contiene el delimitador, comillas dobles, salto de línea o retorno de carro. Dentro de un campo entre comillas, las comillas dobles se escapan duplicándolas (di "hola" se convierte en "di ""hola"""). Los saltos de línea dentro de un campo entrecomillado se mantienen literalmente — el parser cuenta las comillas no escapadas para saber si sigue dentro del campo. null y undefined se convierten en celda vacía; eso significa que un round-trip JSON → CSV → JSON no distingue cadena vacía de null. Los números, booleanos y el literal null sí se reconocen al ir CSV → JSON, así que una celda con true se convierte en booleano JSON.

Cómo se escapan los valores

Algunos ejemplos de lo que hace el conversor en casos delicados. El delimitador en estos ejemplos es la coma.

Valor de entrada Celda CSV
hellohello
a,b"a,b"
say "hi""say ""hi"""
line1\nline2"line1\nline2"
null(vacío)
{a: 1, b: 2}1,2 con aplanado activo

Preguntas frecuentes

¿Mis datos se envían a algún sitio?

No. La conversión ocurre por entero en tu navegador. La página no carga bibliotecas de terceros para CSV — el parser y el serializador están en el código de la propia página. Comprueba en DevTools → Network: ningún request se dispara cuando pegas o conviertes.

¿Y si mis objetos tienen claves diferentes?

La cabecera es la unión de todas las claves vistas, en el orden en que aparecen por primera vez. Las filas a las que les falta una clave producen una celda vacía en esa columna. Así lo manejan Pandas, las importaciones de Excel y la mayoría de las herramientas de ETL.

¿Cómo se exportan los arrays dentro de JSON?

Los arrays se serializan como JSON en una sola celda CSV, así que un objeto como {tags: ["a","b"]} se convierte en una celda con el texto literal ["a","b"]. Conserva todos los datos pero no es óptimo para tablas dinámicas — si quieres una fila por etiqueta, expande el array antes de convertir.

¿Por qué mi Excel europeo abre el CSV en una sola columna?

Excel en muchos locales europeos usa punto y coma como delimitador de CSV para que la coma quede libre para los decimales. Cambia al chip ; en el conversor y el archivo hará round-trip sin problemas.

¿CSV → JSON detecta números y booleanos?

Sí. Las celdas que contienen únicamente un número, true, false o null se convierten al tipo JSON correspondiente. Lo demás permanece como cadena. Los ceros a la izquierda se mantienen como cadena para no estropear teléfonos y códigos postales.

¿Funciona con archivos muy grandes?

Hasta unos pocos megabytes, sí. Más allá de eso la pestaña puede tartamudear porque todo se hace de forma síncrona en el hilo principal. Para exports de cientos de megabytes usa herramientas de línea de comandos como jq, csvkit o miller.