Convertir JSON a CSV online

Qué puedes hacer aquí

• Aceptar un array de objetos JSON planos y rechazar estructuras incompatibles.
• Reunir la unión de claves de todas las filas para construir el encabezado.
• Elegir coma, punto y coma, tabulación o barra vertical como delimitador.
• Escapar delimitadores, comillas y saltos de línea según el formato CSV.
• Proteger valores con apariencia de fórmula y añadir BOM UTF-8 al archivo descargado.

Respuesta rápida: cómo convertir JSON a CSV

Pega un array como `[{"id":"001","nombre":"Ana"},{"id":"002","nombre":"Luis"}]`, elige el separador y pulsa «Convertir a CSV». La primera línea contendrá los encabezados `id,nombre`; las siguientes representarán cada objeto. Si una propiedad aparece solo en objetos posteriores, esta versión la incluye igualmente en el conjunto de columnas y deja vacía la celda de las filas que no la tengan.

El JSON debe ser válido y su raíz debe ser un array no vacío de objetos planos. Un objeto único, un array de números o una propiedad que contenga otro objeto o array se rechazan. Esa decisión evita presentar `[object Object]` como si fuera una conversión correcta. Primero aplana o normaliza estructuras anidadas con una regla que defina los nombres de columna.

Objetos planos, columnas y valores ausentes

CSV representa una tabla rectangular: todas las filas comparten el mismo conjunto de columnas. JSON permite que cada objeto tenga claves diferentes. FunnyTools construye la unión de claves en orden de primera aparición. Si la primera fila tiene `id,nombre` y la segunda añade `país`, el encabezado será `id,nombre,país`; la primera fila tendrá una celda vacía en `país`.

Una propiedad ausente y una propiedad con `null` pueden terminar visualmente como celdas vacías, por lo que el CSV no conserva toda la semántica de JSON. También se pierde la distinción nativa entre número, booleano y cadena: `12`, `true` y `"0012"` se convierten en texto tabular. Documenta qué significa vacío y define tipos al importar el archivo en el destino.

• La raíz debe ser un array de objetos, no un objeto único.
• Las claves de todas las filas forman el encabezado.
• Objetos y arrays anidados se rechazan en vez de serializarse de forma ambigua.
• CSV no conserva tipos JSON ni un esquema formal.

Coma o punto y coma para Excel y otros destinos

La coma es el delimitador interoperable más habitual. En configuraciones regionales donde la coma representa decimales, Excel puede esperar punto y coma al abrir un CSV directamente. Esta página permite escoger ambos, además de tabulación o barra vertical. El mejor separador no depende del idioma de la interfaz sino del contrato del sistema que leerá el archivo.

Los valores que contienen el delimitador se escriben entre comillas dobles. Una comilla dentro del texto se duplica y un salto de línea permanece dentro de un campo entrecomillado. No necesitas eliminar signos de puntuación del contenido. Abre una descarga de prueba y confirma que la aplicación muestra el mismo número de columnas; si todo aparece en una sola, importa indicando el delimitador o genera otra variante.

Protección frente a fórmulas CSV

Excel, LibreOffice y otras hojas pueden interpretar una celda que empieza por `=`, `+`, `-`, `@`, tabulación o retorno de carro como fórmula. Si el JSON contiene texto no confiable, abrir el CSV puede ejecutar una expresión o producir enlaces y cálculos inesperados. Con «Proteger celdas que parecen fórmulas» activado, Papa Parse antepone una comilla simple a esos valores.

La protección modifica la representación de la celda: `=1+1` pasa a texto con prefijo. Es apropiada para revisión humana en una hoja, pero puede ser incorrecta si el archivo alimenta un sistema que necesita la cadena exacta o si los negativos son cantidades legítimas. Evalúa la procedencia y el receptor. Desactivar la opción no declara el archivo seguro; traslada la responsabilidad al flujo de importación.

UTF-8, BOM y caracteres regionales

La salida se genera como texto Unicode. Al descargar, la opción BOM añade los bytes de identificación UTF-8 que ayudan a algunas versiones de Excel a reconocer tildes, `ñ` y otros alfabetos al abrir el archivo con doble clic. El BOM no cambia las celdas visibles en el cuadro y no es cifrado, firma ni validación.

Algunos parsers técnicos no esperan BOM y pueden tratarlo como parte del primer encabezado. Para una API, base de datos o herramienta de línea de comandos, consulta la especificación y desactiva «Añadir BOM UTF-8» si exige UTF-8 sin marca. Si Excel sigue usando columnas incorrectas, el problema suele ser el delimitador, no la codificación; configura ambos de forma separada.

Fechas, números largos y ceros iniciales

CSV no lleva metadatos de tipo. Una hoja puede convertir `00123` en `123`, un UUID en notación inesperada, una fecha ambigua según la región o un identificador largo en notación científica. El texto exportado puede ser correcto y aun así verse alterado al abrirlo. Importa columnas sensibles como texto y verifica una muestra antes de guardar desde la hoja.

No agregues un apóstrofo a todo por rutina si el archivo será consumido por software, porque ese carácter puede convertirse en dato real. Define una estrategia por columna en el sistema de destino. Esta herramienta no aplica formatos de Excel, no crea XLSX y no controla cómo otra aplicación interpreta el CSV después de descargarlo.

Saltos de línea, comillas y prueba de ida y vuelta

Un comentario con coma, comillas y varias líneas debe quedar como una sola celda entrecomillada. Comprueba al menos un caso complejo. La vista de texto puede mostrar varias líneas físicas dentro de una fila lógica; por eso contar solo saltos de línea no siempre equivale a contar registros. Usa un parser CSV o la importación de la hoja para validar.

Una prueba de ida y vuelta consiste en convertir un pequeño JSON a CSV y volver a analizarlo. Sirve para comprobar encabezados y texto, pero no recuperará automáticamente tipos, `null`, objetos anidados ni diferencias entre propiedad ausente y celda vacía. No prometas una reversibilidad perfecta entre formatos con capacidades distintas.

Privacidad, tamaño y control de calidad

La conversión y la descarga ocurren en el navegador; FunnyTools no recibe el JSON ni conserva el CSV. El portapapeles y el archivo quedan bajo el control del dispositivo. Evita datos reales si el equipo, las extensiones, la carpeta de descargas o la sincronización no están autorizados para esa información.

La página está pensada para muestras y conjuntos manejables. Un array muy grande puede agotar memoria o bloquear un móvil. Para exportaciones masivas usa un proceso reproducible con logs, validación de esquema y manejo de errores por fila. Aquí no hay paginación, streaming, reglas de negocio, deduplicación ni confirmación de una importación posterior.

Cómo utilizarla paso a paso

1. Prepara un array JSON no vacío con objetos planos y conserva una copia de la fuente.
2. Pega el JSON y elige el separador exigido por Excel o el sistema receptor.
3. Decide si necesitas protección contra fórmulas y BOM UTF-8 en la descarga.
4. Convierte y revisa filas, columnas, claves tardías, comillas y saltos de línea.
5. Descarga una muestra, impórtala indicando tipos y confirma el resultado antes del lote completo.

Situaciones en las que resulta útil

• Abrir en Excel una respuesta de API formada por objetos planos.
• Exportar datos con punto y coma para una configuración regional concreta.
• Conservar una columna que aparece solo a partir del segundo objeto.
• Neutralizar texto de usuario que empieza por un signo de fórmula antes de revisarlo.
• Descargar nombres con tildes y ñ como CSV UTF-8 con BOM.

Ejemplos completos

Límites y comprobaciones importantes

• Solo se aceptan arrays no vacíos de objetos planos.
• Las columnas se obtienen de todas las filas, no únicamente de la primera.
• La protección de fórmulas y el BOM están activados por defecto en la página española.
• CSV pierde tipos, anidamiento y parte de la diferencia entre ausente, vacío y null.
• La descarga es CSV UTF-8, no un libro XLSX con formato de columnas.

Preguntas frecuentes