Working with YAML and Java Properties Configuration
What this converter does
YAML and Java .properties are two ways of writing the same configuration. Properties files store one flat key=value pair per line, using dots to imply hierarchy (server.servlet.context-path=/api). YAML expresses that same hierarchy as real indentation and nesting. This tool reads either format, works out which one you pasted, and rewrites it as the other — expanding dotted keys into a nested tree, or flattening a tree back into dotted paths.
Because the conversion is bidirectional and runs on detected structure rather than a fixed template, you can round-trip a file (YAML → Properties → YAML) and get an equivalent result back.
When to use it
The most common case is a Spring Boot project migrating between application.properties and application.yml. Teams usually start with properties and switch to YAML once the configuration grows deep enough that dotted keys become hard to read. Going the other direction is just as useful when a tool or deployment pipeline expects flat properties.
It is also handy for quickly diffing two configs, converting a snippet from documentation into the format your project actually uses, or normalising indentation and array style before committing.
Example: a server block
The properties lines server.port=8080 and server.servlet.context-path=/api become a nested YAML block where server contains port: 8080 and a servlet key holding context-path: /api. Convert it back and the dotted keys reappear exactly. Numbers like 8080 stay unquoted so they keep their integer type instead of becoming strings.
Format notes and edge cases
Comments can be preserved through the conversion when the option is enabled, which matters for documented config files. Arrays can be emitted as YAML dash lists or as indexed properties (name[0], name[1]). Adjustable indentation and string-quoting (auto, always, never) let you match your team's style guide. Auto type detection keeps booleans, integers, and null values from being wrapped in quotes.