Cómo convertir JSON a CSV
-
1. Elige tu archivo JSON
Arrastra el archivo a la zona indicada o selecciónalo con el botón «Elegir archivo». El archivo nunca sale de tu navegador.
-
2. Revisa la codificación si es necesario
FormatCue detecta automáticamente la codificación del archivo (UTF-8, UTF-16, Windows-1252). Puedes cambiarla manualmente si el texto no se ve correctamente.
-
3. Convierte el archivo
Pulsa «Convertir a CSV» para generar el resultado. Los objetos anidados se aplanan con notación de puntos y los arrays se conservan como texto JSON en una sola celda.
-
4. Revisa, copia o descarga el CSV
Puedes editar el resultado directamente en el área de texto antes de continuar. «Copiar» y «Descargar» siempre usan el contenido actual de esa área.
Qué estructuras JSON admite FormatCue
El conversor admite las siguientes estructuras de JSON:
- Un array de objetos: cada objeto se convierte en una fila y las columnas se generan a partir de las claves encontradas.
- Un objeto único: se convierte en una única fila.
- Un array de valores simples (números, texto, booleanos): se genera una única columna llamada value.
- Objetos anidados: se aplanan usando notación de puntos, por ejemplo user.name, hasta un máximo de 50 niveles de profundidad.
JSON anidado y columnas CSV
Cuando un objeto contiene otro objeto, FormatCue genera una columna por cada propiedad anidada, combinando las claves con un punto. Por ejemplo, { "user": { "name": "Ana" } } se convierte en una columna llamada user.name. Los arrays que aparecen dentro de un objeto no se descomponen en columnas adicionales: se guardan como texto JSON en una sola celda, por ejemplo ["a","b"].
Ejemplo antes y después
Antes (JSON)
[
{
"id": 1,
"name": "Ana",
"tags": ["vip","new"],
"address": { "city": "Santiago", "country": "Chile" }
}
]
Después (CSV)
id,name,tags,address.city,address.country
1,Ana,"[""vip"",""new""]",Santiago,Chile
Protección contra fórmulas en CSV
Algunos programas de hojas de cálculo interpretan como fórmula cualquier celda que empiece por =, +, - o @. La protección contra fórmulas, activada por defecto, antepone una comilla a esos valores para que se muestren como texto en lugar de ejecutarse como fórmula. Los números negativos legítimos, como -42, no se modifican. Esta protección no garantiza seguridad en todas las aplicaciones de hojas de cálculo, por lo que sigue siendo buena práctica revisar el archivo antes de usarlo en flujos sensibles.
Casos de uso habituales
- Exportar datos de una API en JSON a un formato compatible con hojas de cálculo.
- Preparar datos estructurados para Excel o Google Sheets.
- Convertir exportaciones de aplicaciones que entregan datos en JSON.
- Inspeccionar registros JSON como filas y columnas para revisarlos más fácilmente.
- Transformar datos de objetos anidados en columnas CSV planas.
Privacidad
FormatCue procesa tu archivo JSON localmente, dentro de tu propio navegador. El contenido del archivo no se sube a ningún servidor ni se envía a través de la red en ningún momento del proceso: la lectura, el análisis del JSON y la generación del CSV ocurren en tu dispositivo.
Preguntas frecuentes
¿Qué estructuras de JSON admite este conversor?
Admite un array de objetos, un objeto único, un array de valores simples y objetos anidados, que se aplanan usando notación de puntos, por ejemplo user.name.
¿Cómo se convierten los objetos anidados?
Cada propiedad anidada se convierte en una columna combinando las claves con un punto, por ejemplo user.address.city. FormatCue admite hasta 50 niveles de profundidad; si un JSON supera ese límite, las ramas adicionales se truncan y se muestra un aviso.
¿Qué ocurre con los arrays dentro de un objeto?
Los arrays no se dividen en columnas adicionales. Se guardan como una única celda con el array en formato JSON, por ejemplo ["a","b"].
¿FormatCue sube mi archivo JSON a un servidor?
No. Todo el procesamiento —lectura, análisis del JSON y generación del CSV— ocurre en tu navegador mediante JavaScript. El archivo nunca se envía por red.
¿Qué es la protección contra fórmulas en CSV?
Algunos programas de hojas de cálculo interpretan como fórmula cualquier celda que empiece por =, +, - o @. La protección, activada por defecto, antepone una comilla a esos valores para mostrarlos como texto. No garantiza protección en todas las aplicaciones de hojas de cálculo.
¿Puedo editar el CSV antes de descargarlo?
Sí. El resultado aparece en un área de texto editable. Tanto «Copiar» como «Descargar» usan siempre el contenido actual de esa área, incluidos tus cambios manuales.