CrateX.app

Convertidor JSON ↔ CSV

Conversión bidireccional entre CSV/TSV y JSON con detección automática del delimitador, mapeo de encabezados, recorte de campos y salto de líneas vacías. Útil para importación/exportación de datos, procesamiento de hojas de cálculo y preparación de payloads de API.

🚀 Inicio rápido

Pegue o ingrese datos CSV/TSV en el editor CSV de la derecha y el JSON de la izquierda se sincronizará automáticamente
También puede ingresar JSON en el editor JSON de la izquierda y el CSV de la derecha también se sincronizará automáticamente.
El delimitador está configurado en "Auto" de forma predeterminada. La herramienta inspecciona la primera fila y detecta coma, tabulación, punto y coma o barra vertical (|).
Al activar «Usar fila de encabezado», la primera fila del CSV se usa como claves del objeto JSON; al desactivarlo, se convierte en una matriz bidimensional.
Utilice "Recortar campos" y "Omitir líneas vacías" para limpiar datos CSV desordenados.
Cada editor se puede descargar por separado: el lado JSON descarga un archivo .json y el lado CSV descarga un archivo .csv o .tsv según el delimitador actual.

📌 Escenarios comunes

Excel a JSON: copie celdas separadas por tabulaciones de Excel al panel CSV y conviértalas a una matriz de objetos JSON al instante.
Respuesta API a hoja de cálculo: convierta respuestas JSON a CSV para analizarlas en Excel o Google Sheets.
Preparación de importación de bases de datos: convierta conjuntos de datos CSV a JSON para importaciones de API por lotes.
Análisis de registros: convierta registros CSV a JSON para realizar consultas estructuradas con herramientas como jq.
Migración de configuración: cambie entre tablas de mapeo CSV y archivos de configuración JSON.
Limpieza de datos: limpie rápidamente los datos exportados con recorte de campos y omisión de líneas vacías.

🧭 Consejos de uso

Los datos pegados desde Excel suelen estar delimitados por tabulaciones y se detectan correctamente. Si la detección es incorrecta, elija el delimitador manualmente.
Cuando «Usar fila de encabezado» está activado, la primera fila no se trata como datos, sino como nombres de columna. Si tu CSV no tiene encabezado, desactiva esta opción para no perder la primera fila de datos.
Si existen nombres de encabezado duplicados, los sufijos se agregan automáticamente (por ejemplo, nombre, nombre_2) para mantener las claves JSON únicas.
JSON → CSV funciona mejor con matrices de objetos planos. Los objetos/matrices anidados se serializan como cadenas JSON en celdas.
Los campos que contienen delimitadores, nuevas líneas o comillas dobles se citan y se escapan automáticamente según las reglas CSV.

⚠️ Limitaciones y compatibilidad

CSV es un formato tabular plano y no puede representar de forma nativa estructuras anidadas. Los objetos/matrices JSON anidados se serializan como cadenas y no se pueden restaurar por completo en la conversión inversa.
CSV almacena valores como texto. Después de un viaje de ida y vuelta JSON → CSV → JSON, los números y valores booleanos pueden volver como cadenas.
La lista de materiales UTF-8 (\uFEFF) se elimina automáticamente. No se admiten otras codificaciones (por ejemplo, GBK o Shift-JIS); primero convierta a UTF-8.
Al igual que JSON en JavaScript, esta herramienta sigue los límites de IEEE 754. Los números enteros más allá del rango seguro de 53 bits pueden perder precisión.

🔒 Privacidad y seguridad

Todo el procesamiento ocurre localmente en su navegador. Tus datos nunca salen de tu dispositivo.

❓ Preguntas frecuentes

¿Qué es CSV y cómo se relaciona con TSV y Excel?

CSV (valores separados por comas) es un formato de tabla de texto sin formato donde cada línea es un registro y los campos están separados por comas. TSV es la variante delimitada por tabulaciones. Excel puede abrir y exportar ambos formatos, pero .xlsx en sí es un formato de libro binario. Esta herramienta funciona con archivos CSV/TSV de texto sin formato, no con archivos .xlsx. Históricamente, CSV no tenía un estándar único y estricto. En 2005, RFC 4180 definió reglas comunes: los campos están separados por comas, los campos con caracteres especiales están entre comillas dobles y las comillas dentro de los campos entre comillas se escapan como dos comillas dobles. Diferentes aplicaciones aún implementan CSV con pequeñas diferencias, razón por la cual los problemas de importación/exportación son comunes.

¿Cómo funciona la detección de delimitadores "automática"? ¿Puede estar mal?

La herramienta toma la primera fila del CSV y cuenta cuántas comas, tabulaciones, puntos y comas y barras verticales (|) aparecen fuera de comillas; luego elige como delimitador el que más se repite. Para la mayoría de CSV/TSV bien formados, este método es preciso. Puede fallar si solo hay una columna (sin delimitador visible) o si el contenido de los campos incluye muchos caracteres delimitadores. En esos casos, selecciona el delimitador manualmente.

¿Qué cambia cuando "Usar fila de encabezado" está activado o desactivado?

Al activar esta opción, la primera fila del CSV se trata como nombres de columna y cada registro se convierte en un objeto JSON con esas columnas como claves (por ejemplo, {"name": "Alice", "age": "30"}). Al desactivarla, todas las filas, incluida la primera, se tratan como datos y se convierten en una matriz bidimensional (por ejemplo, [["name", "age"], ["Alice", "30"]]). En la conversión JSON → CSV, activar el encabezado hace que las claves del objeto se escriban en la primera fila del CSV.

Mi JSON contiene objetos anidados. ¿Puedo volver a convertir sin pérdidas después de CSV?

No del todo. Durante JSON → CSV, los objetos/matrices anidados se serializan con JSON.stringify en el texto de la celda. Durante CSV → JSON, esos valores siguen siendo cadenas y no se analizan automáticamente en objetos. Si necesita fidelidad estructural, aplane JSON antes de la conversión.

¿Puedo convertir datos copiados desde Excel directamente?

Sí. Cuando copia un rango de celdas de Excel y lo pega en el editor CSV, los datos suelen estar delimitados por tabulaciones. La detección automática lo identifica como TSV y lo convierte correctamente. Si desea una descarga .csv delimitada por comas, cambie el delimitador a coma antes de descargar.

¿Cómo se manejan las comillas y los saltos de línea en los campos CSV?

Según RFC 4180: si un campo contiene delimitadores, saltos de línea o comillas dobles, todo el campo se envuelve entre comillas dobles; las comillas dobles dentro del campo se escapan como dos comillas dobles consecutivas (""). Esta regla se aplica tanto al analizar la entrada como al generar la salida. Si las comillas de entrada no se cierran correctamente, aparecerá el error «Las comillas CSV no están cerradas».