🌐 ES

🔄 Conversor de YAML ↔ JSON / CSV

Convierte YAML y JSON en ambos sentidos. Útil para convertir archivos de configuración (docker-compose, GitHub Actions, manifiestos de k8s) a JSON para inspección programática, o convertir JSON a YAML legible. La pestaña JSON↔CSV convierte datos de array plano en CSV listo para hoja de cálculo.

GUÍA

Más información

01

1. Cuándo usar YAML frente a JSON

JSON está optimizado para el intercambio de datos máquina a máquina (respuestas de API, configuración guardada), y su gramática estricta significa menos sorpresas al analizar. YAML se basa en la sangría, admite comentarios (#) y se lee bien para las personas, por eso domina los archivos de configuración: docker-compose.yml, flujos de trabajo de GitHub Actions, manifiestos de Kubernetes, playbooks de Ansible. Usa esta herramienta para convertir una configuración YAML a JSON para un manejo programático, o convertir datos JSON en YAML ordenado y legible por humanos.

02

2. Advertencias de conversión

YAML puede expresar más que JSON: anclajes (&), aliases (*), separadores de múltiples documentos (---) y escalares de bloque (| y >). Convertir un documento que usa estos elementos a JSON expande anclajes/aliases a sus valores literales, y solo se convierte el primer documento de varios. JSON→YAML siempre es seguro, ya que JSON es prácticamente un subconjunto de YAML. Cuidado con las cadenas que parecen números (por ejemplo, un código postal "01234"); sin comillas, YAML podría interpretarlas como números.

03

3. JSON ↔ CSV y estructuras anidadas

CSV solo puede representar una tabla (filas y columnas), por lo que no puede contener directamente objetos/arrays anidados de JSON. Esta herramienta aplana automáticamente los objetos anidados en columnas con notación de puntos como "user.name", "user.age", y CSV→JSON reconstruye la estructura anidada original desde esos encabezados de notación de puntos. Los valores de array (por ejemplo, una lista de etiquetas) se guardan como una cadena JSON sin procesar dentro de la celda; es más seguro hacer ida y vuelta con esta herramienta que editarlo manualmente en una hoja de cálculo.

Preguntas frecuentes

¿Qué sintaxis de YAML se admite?
Usamos la biblioteca js-yaml, que admite la sintaxis estándar de YAML 1.2 (mapas, secuencias, escalares, comentarios, anclajes/aliases, escalares de bloque, múltiples tipos de datos), cubriendo la mayor parte de la sintaxis real de archivos de configuración.
¿Qué pasa con los objetos anidados en JSON→CSV?
Se aplanan automáticamente en columnas de notación con puntos "padre.hijo". Por ejemplo, {"user":{"name":"Kim"}} se convierte en una columna "user.name" que contiene "Kim".
¿Puedo convertir a CSV un JSON que contenga arrays?
El nivel superior debe ser un array de objetos (por ejemplo [{"a":1}]). Los valores de array dentro de cada objeto (por ejemplo, una lista de etiquetas) se guardan como una cadena JSON sin procesar dentro de la celda.
¿Se envían mis datos a un servidor?
No. Toda la conversión ocurre completamente en tu navegador (JavaScript); nada de lo que ingreses se envía a un servidor.