Ir al contenido principal
Bethemesh

Convertir CSV a JSON (y JSON a CSV)

Pasa fácilmente de datos tabulares CSV a una estructura JSON, o al contrario, y recupera el resultado listo para copiar o descargar.

  • Portapapeles

Integrar este widget

Personaliza el aspecto, comprueba la vista previa y copia el código.

Vista previa

Tipo de código de integración

Código para copiar

Se adapta a tu página y Bethemesh ajusta su tamaño automáticamente.

¿Te ha resultado útil esta herramienta?

¿Cómo funciona esta herramienta?

CSV describe registros y columnas, mientras JSON puede representar objetos, listas y varios tipos de valores. Este convertidor enlaza una tabla CSV con cabecera y una lista JSON de objetos planos. Sirve para preparar un ejemplo de API, recuperar una exportación de aplicación o mover datos entre una hoja de cálculo y un script. Los dos sentidos no garantizan una ida y vuelta idéntica: CSV no distingue de forma natural null, un campo ausente y una cadena vacía, ni un número del texto que se le parece. Esas diferencias requieren un esquema explícito.

Elige expresamente coma, punto y coma o tabulación. El ajuste sirve para leer CSV en un sentido y escribirlo en el otro; esta interfaz no detecta automáticamente ni ofrece barra vertical. CSV a JSON trata siempre el primer registro lógico como cabecera y crea un objeto por registro posterior. Se retiran espacios exteriores de los títulos. Los nombres vacíos o repetidos reciben sustitutos para conservar todas las columnas; los campos adicionales de una fila larga también obtienen propiedades, evitando sobrescribir celdas por colisión de nombres.

Todos los valores leídos desde CSV siguen siendo cadenas JSON. Un importe 12,50 no se infiere como número y la referencia 001 mantiene sus ceros iniciales. Los campos citados pueden contener separadores, comillas duplicadas y varias líneas. Una comilla sin cerrar bloquea la conversión. Para JSON a CSV, la entrada debe ser una lista no vacía de objetos con celdas de texto, números finitos, booleanos o null. Un objeto aislado, una lista numérica o una celda anidada no son una tabla plana admitida.

Las propiedades encontradas en los objetos forman las columnas exportadas. Una propiedad ausente o null se convierte en celda vacía; los booleanos pasan al texto true o false y los números usan su representación textual JavaScript. Los objetos y listas anidados se rechazan en vez de convertirse en texto inútil: aplánalos antes si necesitas columnas con rutas explícitas. La salida JSON lleva sangría y el CSV añade comillas según el separador. La importación limita los archivos a 5 MiB y lee UTF-8. No se conservan estilos ni metadatos de un libro de cálculo.

Cómo utilizar esta herramienta

  1. Elige el sentido y comprueba la forma de entrada

    Para CSV a JSON, aporta una cabecera real. Para JSON a CSV, prepara una lista de objetos planos, no toda la envoltura de una respuesta de API que contiene los resultados en otra propiedad.

  2. Ajusta separador y tipos esperados

    Selecciona el delimitador real del CSV o el requerido en la salida. Comprueba la puntuación JSON: comillas dobles en los nombres, comas entre elementos y punto en números decimales, aunque el contenido esté en español.

  3. Examina valores potencialmente ambiguos

    Ejecuta la conversión y revisa propiedades generadas, identificadores, valores nulos y números. Copia o exporta el formato seleccionado y prueba el resultado en la aplicación destinataria antes de realizar una importación importante.

Casos de uso

Preparar una carga tabular para una API

Convierte una pequeña exportación CSV en lista de objetos para un script o una prueba de API y comprueba después los tipos requeridos, sin suponer que se haya realizado una conversión numérica automática.

Abrir una exportación JSON plana en columnas

Genera CSV desde una lista de objetos simples para una aplicación tabular. Las propiedades que faltan en ciertos registros se convierten en celdas vacías y mantienen la alineación con el conjunto de columnas.

Conservar los ceros de una referencia

Lee una columna de referencias CSV como cadenas JSON y conserva su escritura original. No obligas así al convertidor a adivinar qué secuencias de cifras son identificadores y cuáles representan cantidades.

Ejemplos

Mantener precios como texto JSON

CSV a JSON con punto y coma conserva 001 y 002 como cadenas, igual que los precios con coma decimal. El resultado no presenta importes ya tipados para calcular: el programa consumidor debe decidir expresamente cómo convertir esos valores.

Entrada

id;precio
001;12,50
002;8,00

Resultado

[
  {
    "id": "001",
    "precio": "12,50"
  },
  {
    "id": "002",
    "precio": "8,00"
  }
]

Exportar números, booleanos y ausencias

JSON a CSV con punto y coma escribe 12.5 y true para A. El importe null de B queda vacío y su propiedad activo ausente también. Una conversión inversa no recuperaría la diferencia entre esas dos formas de expresar ausencia.

Entrada

[{"id":"A","importe":12.5,"activo":true},{"id":"B","importe":null}]

Resultado

id;importe;activo
A;12.5;true
B;;

Consejos y buenas prácticas

  • Para conservar sin redondeo un identificador JSON grande, proporciónalo como cadena entre comillas. Los números se leen con precisión JavaScript, no mediante una representación de enteros arbitrariamente grandes que preserve todos sus dígitos.
  • Evita propiedades repetidas dentro de un mismo objeto JSON: el lector conserva el último valor antes de convertir. Es distinto de las cabeceras CSV duplicadas, que pueden renombrarse manteniendo todas las columnas físicas originales.
  • No cambies globalmente comas por puntos para convertir importes: modificarías también separadores JSON o CSV. Aplica una conversión de tipos específica sobre las columnas que realmente deban contener cantidades numéricas.

Fuentes y referencias

Preguntas frecuentes

¿Por qué los números CSV aparecen entre comillas en JSON?

CSV no proporciona tipos fiables para sus celdas. Conservar cadenas protege referencias con ceros iniciales y otras escrituras intencionadas. El esquema de tu aplicación debe decidir qué columnas se convierten después en números, en lugar de delegarlo al delimitador.

¿Puedo convertir directamente un objeto JSON anidado?

No. JSON a CSV exige aquí una lista de objetos planos. Aplana las rutas anidadas o extrae antes la propiedad que contiene los registros. Los objetos no se reemplazan silenciosamente por [object Object] cuando no son celdas escalares válidas.

¿Qué ocurre con null en el CSV generado?

Se convierte en celda vacía, como una propiedad ausente o una cadena vacía. Esta conversión no conserva esa distinción de tipo en CSV. Si es esencial, codifica una convención explícita antes de exportar y documéntala para el destinatario.

¿Una ida y vuelta CSV y JSON conserva todos los tipos?

No. Los valores leídos desde CSV vuelven como cadenas. Números, booleanos y ausencias exportados en CSV no recuperan automáticamente sus tipos originales. Los títulos también pueden normalizarse para evitar colisiones de propiedades en los objetos.

Workflow recomendado

Descubre herramientas que encajan antes, después o como complemento de esta.

Funciona bien con

Convierte archivos Excel, CSV y otros formatos de hojas de cálculo directamente en tu navegador.

Datos y hojas de cálculoDestacadaUsar esta herramienta

Formatea, minimiza y valida un documento JSON para hacerlo más legible o compacto.

Datos y hojas de cálculoDestacadaUsar esta herramienta

Usar antes

Siguiente paso

Formatea, minimiza y valida un documento JSON para hacerlo más legible o compacto.

Datos y hojas de cálculoDestacadaUsar esta herramienta