Trabajar con configuración en YAML y Java Properties
Qué hace este conversor
YAML y los archivos .properties de Java son dos formas de escribir la misma configuración. Los archivos properties guardan un par clave=valor plano por línea y usan puntos para insinuar la jerarquía (server.servlet.context-path=/api). YAML expresa esa misma jerarquía mediante indentación y anidamiento reales. Esta herramienta lee cualquiera de los dos formatos, detecta cuál pegaste y lo reescribe en el otro: expande las claves con puntos en un árbol anidado o aplana un árbol de vuelta a rutas con puntos.
Como la conversión es bidireccional y se basa en la estructura detectada en lugar de una plantilla fija, un archivo puede hacer el ciclo completo (YAML → Properties → YAML) con las mismas claves y valores. Para que las listas sigan siendo listas, elige Indexado ([0]) en Formato de Array: con el estilo por defecto, separado por comas, una lista vuelve como un único valor de texto y las líneas # acaban al principio.
Cuándo usarlo
El caso más habitual es un proyecto de Spring Boot que migra entre application.properties y application.yml. Los equipos suelen empezar con properties y pasan a YAML cuando la configuración crece tanto que las claves con puntos se vuelven difíciles de leer. Ir en la dirección contraria resulta igual de útil cuando una herramienta o un pipeline de despliegue espera properties planas.
También es práctico para comparar rápidamente dos configuraciones, convertir un fragmento de la documentación al formato que realmente usa tu proyecto, o normalizar la indentación y el estilo de arrays antes de hacer commit.
Ejemplo: un bloque de servidor
Las líneas de properties server.port=8080 y server.servlet.context-path=/api se convierten en un bloque YAML anidado donde server contiene port: 8080 y una clave servlet que guarda context-path: /api. Conviértelo de vuelta y las claves con puntos reaparecen exactamente igual. Números como 8080 permanecen sin comillas para conservar su tipo entero en lugar de convertirse en cadenas.
Notas de formato y casos límite
Con Preservar Comentarios activado (el valor por defecto), las líneas que empiezan por # pasan al principio del resultado; un comentario al final de una línea no se conserva, y un comentario no queda junto a la clave que describía. De YAML a Properties, una lista se convierte en un único valor separado por comas (tools=a,b) o en líneas indexadas (tools[0]=a, tools[1]=b); de Properties a YAML, las líneas indexadas se convierten en una lista YAML con guiones. La sangría ajustable y las comillas en cadenas (auto, siempre, nunca) permiten adaptarse a la guía de estilo de tu equipo. La detección automática de tipos evita que booleanos, enteros y valores null se envuelvan entre comillas.