Seleccionar idioma

Conversor de CSV a JSON

Convierte datos CSV en JSON estructurado al instante. Admite distintos delimitadores, campos entrecomillados y salida en array JSON o NDJSON.

Mehmet Demiray Publicado Actualizado
Compartir
Carácter que separa los valores en tu CSV
Tratar la primera fila como nombres de columna
Interpretar números y verdadero/falso en lugar de texto
Ignorar líneas en blanco en la entrada
Espaciado usado para formatear la salida JSON

Qué es la conversión de CSV a JSON

El CSV guarda datos en filas separadas por comas, donde la primera línea suele contener los nombres de columna. Es un formato plano, ideal para hojas de cálculo y exportaciones de bases de datos, pero limitado cuando necesitas estructuras anidadas. El JSON, en cambio, organiza la información en objetos y arrays, el lenguaje habitual de las API y las aplicaciones web modernas.

Convertir de uno a otro significa tomar cada fila del CSV y convertirla en un objeto JSON, usando la cabecera como claves. Una tabla de 1000 filas se transforma así en un array de 1000 objetos, cada uno con campos con nombre.

La diferencia estructural es clara: el CSV es tabular y bidimensional, mientras que el JSON admite jerarquías. Por eso la conversión resulta natural cuando partes de datos planos, y solo requiere reglas adicionales cuando quieres reconstruir anidamientos a partir de columnas. Si después necesitas revisar el resultado, el formateador de JSON te ayuda a leerlo con claridad.

Cómo funciona el conversor

El proceso empieza analizando el texto CSV. La herramienta detecta el delimitador, que puede ser coma, punto y coma o tabulador, y separa cada línea en campos. Los valores entre comillas se tratan como una unidad, de modo que una coma dentro de un texto entrecomillado no rompe la columna. También interpreta las comillas escapadas y los valores que ocupan varias líneas.

La primera fila se usa como conjunto de claves. A partir de ahí, cada fila siguiente se convierte en un objeto donde cada valor queda asociado a su columna correspondiente. El resultado se ensambla en un array JSON.

Puedes elegir entre dos salidas: un único array con todos los registros, o NDJSON, donde cada objeto ocupa su propia línea, un formato cómodo para procesar grandes volúmenes en streaming. Los casos límite, como celdas vacías o filas con menos columnas de las esperadas, se gestionan de forma predecible para que el JSON resultante sea siempre válido.

Casos de uso habituales

La conversión de CSV a JSON aparece en muchas situaciones del día a día. El más común es importar datos de una hoja de cálculo a una aplicación web: exportas la tabla como CSV y la conviertes en JSON para alimentar un formulario, una lista o una base de datos.

Otro escenario frecuente es preparar exportaciones de bases de datos para una API. Muchos sistemas vuelcan sus tablas en CSV, pero los servicios que las consumen esperan JSON. La conversión actúa como puente entre ambos mundos.

También es útil en pipelines de transformación de datos, donde el CSV es el punto de entrada y el JSON el formato intermedio que pasa de un proceso a otro. Si trabajas con varios formatos, quizá te interese el conversor de JSON a CSV para el camino inverso, o el conversor de XML a JSON cuando el origen no es tabular. Así cubres todo el ciclo de intercambio entre sistemas.

Delimitadores y campos especiales

No todos los archivos CSV usan la coma como separador. En muchos países europeos, donde la coma es el separador decimal, los programas de hoja de cálculo guardan los datos con punto y coma. Otros sistemas prefieren el tabulador. El conversor reconoce estas variantes para que no tengas que reformatear el archivo antes de empezar.

Los campos entrecomillados merecen atención especial. Cuando un valor contiene el propio delimitador, un salto de línea o una comilla, el CSV lo encierra entre comillas dobles. Dentro de ese campo, una comilla literal se escribe duplicándola. La herramienta interpreta estas reglas y devuelve el texto original sin las comillas de protección.

Los valores multilínea, como una dirección con varias líneas dentro de una sola celda, se conservan íntegros en el JSON resultante. El objetivo es que cada cadena llegue exactamente como estaba, sin truncamientos ni caracteres añadidos, para que la conversión sea fiel al contenido original.

Buenas prácticas al convertir

Antes de convertir, revisa que la primera fila contenga cabeceras claras y sin repetir, ya que esos nombres se convierten en las claves del JSON. Las claves duplicadas pueden provocar que un campo sobrescriba a otro dentro del mismo objeto.

Comprueba también la codificación del archivo. Un CSV guardado en UTF-8 conserva tildes, eñes y otros caracteres correctamente; con codificaciones antiguas pueden aparecer símbolos extraños en el resultado.

Elige el formato de salida según tu destino. Un array JSON es ideal cuando vas a cargar todo el conjunto de una vez, por ejemplo en una llamada a una API. El NDJSON encaja mejor cuando procesas registros uno a uno o trabajas con archivos muy grandes.

Por último, valida el resultado antes de usarlo en producción. Pasar el JSON por el formateador de JSON te permite verificar de un vistazo que la estructura es correcta y que no se han colado errores de comillas o columnas desalineadas.

Las que respondemos con más frecuencia.

¿Cómo convierto un archivo CSV a JSON?

Pega o sube tu contenido CSV en la herramienta. La primera fila se usará como conjunto de claves y cada fila siguiente se transformará en un objeto JSON. El conversor detecta el delimitador y respeta los campos entre comillas de forma automática, así que solo tienes que copiar el JSON resultante cuando termine.

¿Cuáles son las diferencias clave entre CSV y JSON?

El CSV es un formato plano y tabular: filas y columnas separadas por un delimitador, perfecto para hojas de cálculo. El JSON es jerárquico y admite objetos y arrays anidados, el formato habitual de las API y las aplicaciones web. El CSV es más compacto y legible para datos sencillos; el JSON expresa mejor estructuras complejas.

¿Qué pasa con los caracteres especiales y los valores multilínea?

Los campos entre comillas dobles se interpretan como una unidad, de modo que comas, saltos de línea y comillas dentro de un valor se conservan sin romper la estructura. Las comillas escapadas se devuelven como una sola comilla literal y los valores que ocupan varias líneas se mantienen íntegros en el JSON.

¿La conversión es sin pérdida de datos?

El contenido de cada celda se conserva tal cual en el JSON. Lo único que cambia es la estructura, que pasa de tabular a objetos con nombre. Conviene recordar que el CSV no distingue tipos: todo es texto, así que un número o una fecha llegarán como cadena salvo que conviertas los tipos después.

¿Puedo convertir CSV que usa punto y coma como separador?

Sí. La herramienta reconoce coma, punto y coma y tabulador como delimitadores. Esto es muy útil con archivos exportados en regiones donde la coma se usa como separador decimal y las hojas de cálculo guardan los datos separados por punto y coma.

¿Qué diferencia hay entre un array JSON y NDJSON?

Un array JSON agrupa todos los registros dentro de una única estructura entre corchetes, ideal para cargar el conjunto completo de golpe. El NDJSON coloca cada objeto en su propia línea, sin corchetes que lo envuelvan, lo que facilita procesar grandes volúmenes registro a registro o en streaming.