Document format

YAML converter

A .yaml file stores structured data in YAML, a syntax that uses indentation rather than brackets to express nesting. Its readability made it the configuration language of the DevOps era — Kubernetes manifests, CI pipelines, and Ansible playbooks all live in .yaml files.

Private for supported formats — processed in your browser

Convert supported files

Runs on your device

Drop YAML files here

Batch files can each use a different output. Nothing uploads for local conversions.

Working inputs include camera RAW, browser-local audio/video, PDF, CBZ/CBR comics, office documents, ebooks, markup, 3D models, structured text, images, and archives.

Where YAML comes from

Clark Evans proposed YAML in 2001, designing it with Ingy döt Net and Oren Ben-Kiki as a human-friendly data serialization language. The YAML 1.2 revision in 2009 made every JSON document valid YAML, formally positioning it as a superset.

How YAML works

  • Indentation with spaces (tabs are forbidden) expresses structure, with no closing delimiters at all.
  • Anchors (&) and aliases (*) let one node be referenced elsewhere, deduplicating repeated configuration.
  • Multiple documents can share a single file, separated by --- lines.
  • YAML 1.1's implicit typing famously parsed 'no', 'off', and Norway's country code 'NO' as booleans — fixed in 1.2 but alive in many deployed parsers.

When to use YAML

  • Kubernetes resource manifests and Helm charts.
  • CI/CD pipeline definitions across GitHub Actions, GitLab CI, and CircleCI.
  • Ansible playbooks and roles.
  • Front matter blocks at the top of Markdown files for static sites.

Strengths and limitations

Strengths

  • Exceptionally readable for nested configuration.
  • Comments are supported, unlike JSON.
  • Anchors and aliases eliminate copy-paste duplication.
  • Since 1.2, any valid JSON is also valid YAML.

Limitations

  • Whitespace sensitivity makes both hand-editing errors and machine generation fiddly.
  • Implicit typing surprises differ between parser versions.
  • The specification is large and inconsistently implemented across languages.

Compatibility

Every major language has a solid YAML library — PyYAML, js-yaml, go-yaml — and modern editors provide highlighting, folding, and schema-aware linting. Operating systems have no native viewer beyond text editors, which is all the format needs.