JSON y YAML: dos vistas de los mismos datos
JSON y YAML son formatos de serialización de datos que representan el mismo modelo de datos subyacente. YAML es un superconjunto de JSON (desde YAML 1.2), lo que significa que todo documento JSON válido también es YAML válido.
Los dos formatos sirven diferentes casos de uso. JSON se prefiere para comunicación máquina a máquina (APIs, payloads HTTP). YAML se prefiere para archivos de configuración escritos por humanos (manifiestos de Kubernetes, flujos de trabajo de GitHub Actions) porque su sintaxis basada en sangría es más fácil de leer.
Convertir entre los dos es una necesidad diaria para los desarrolladores: transformar un archivo de configuración YAML en JSON para una llamada a la API, o recibir una respuesta JSON y reestructurarla como configuración YAML.
Qué maneja el convertidor
JSON a YAML: Todos los tipos de valor JSON se asignan a sus equivalentes YAML — objetos a mappings, arrays a secuencias. El orden de las claves se preserva por defecto.
YAML a JSON: Los comentarios se eliminan. Las anclas y alias se resuelven — &ancla y *alias se expanden completamente en línea. Los flujos YAML de múltiples documentos se convierten en un array JSON.
Conversión segura de tipos: Nuestro convertidor sigue YAML 1.2 por defecto, tratando solo "true" y "false" como booleanos. Un modo de compatibilidad YAML 1.1 está disponible para configuraciones heredadas.
Características de YAML que no se asignan a JSON
Comentarios: Las líneas YAML que comienzan con # son comentarios. Al convertir YAML a JSON, los comentarios se descartan.
Anclas y alias: YAML permite definir un nodo con &nombre-ancla y referenciarlo con *nombre-ancla. Al convertir a JSON, los alias se expanden completamente en línea.
Tipos binarios y timestamp: Los datos binarios se convierten a cadena base64 en JSON. Los timestamps se convierten a cadenas ISO 8601.