Den raskeste måten å konvertere TOML til YAML er yq -oy '.' file.toml. For manuell konvertering, kartlegg TOML [table]-headere til YAML-innrykkede blokker, TOML-arrays til stiprekse liste, og alltid anførselstegn rundt tvetydige strenger for å unngå “Norge-problemet.”
Rask konvertering: Bruk av yq CLI
TOML (Tom’s Obvious, Minimal Language) nådde sin v1.1.0-utgivelse i desember 2025, men YAML er fortsatt standarden for CI/CD-pipelines og Kubernetes-manifester. Verktøyet yq håndterer konverteringen i en enkelt kommando.
Installer yq
| Plattform | Kommando |
|---|---|
| macOS/Linux | brew install yq |
| Windows | choco install yq |
| Python (pip) | pip install yq |
Den Go-baserte versjonen av Mike Farah foretrekkes for hastighet. Som notert i Mike Farahs yq-dokumentasjon, dekoder verktøyet TOML-strukturen og omkoder den som ren YAML.
Kjør konverteringen
Vis i terminalen:
yq -oy '.' your-config.toml
Lagre til fil:
yq -oy '.' your-config.toml > your-config.yaml
Flagget -oy setter utdataformatet til YAML. Dette håndterer nøkkel-verdi-par, nestede tabeller og arrays.
Syntaksoversettelseskart: TOML-struktur til YAML
Utvikler Drew DeVault har bemerket at mens TOML er populært, håndterer YAML dyp nøsting renere. Her er den nøyaktige tilordningen:
Tabeller til innrykkede nøkler
TOML bruker klamme-headere; YAML bruker innrykk.
| TOML | YAML |
|---|---|
[server] |
server: |
host = "127.0.0.1" |
host: 127.0.0.1 |
port = 8080 |
port: 8080 |
Kritisk forskjell: I TOML er innrykk kun kosmetisk. I YAML er innrykk strukturelt — ett feil mellomrom ødelegger hele konfigurasjonen.
Arrays til stiprekse lister
TOML: ports = [ 8000, 8001 ]
YAML:
ports:
- 8000
- 8001
Som Knightli.com forklarer, gjør YAMLs “blokkstil” lister lesbare, forutsatt at vertikal justering er konsekvent.
Inline-tabeller og punktumseparerte nøkler
| TOML-konstruksjon | YAML-ekvivalent |
|---|---|
[a.b.c] (punktumseparert header) |
a: → b: → c: (nestet innrykk) |
point = { x = 1, y = 2 } (inline-tabell) |
point: → x: 1 → y: 2 |
Praktiske brukstilfeller
Hugo statisk nettstedskonfigurasjon
Hugo aksepterer hugo.toml, hugo.yaml eller hugo.json. De fleste prosjekter starter med TOML (standard), og migrerer deretter til YAML når konfigurasjonen må samkjøres med distribusjonsplattformer som Netlify eller GitHub Actions. Hammer Europe bemerker at hugo-kommandoen leser disse filene for å bestemme hvordan Markdown konverteres til et levende nettsted.
Python-pakking: pyproject.toml til CI/CD YAML
Python-miljøet standardiserte pyproject.toml via PEP 518. Disse innstillingene trenger ofte oversettelse til YAML for GitHub Actions CI/CD-arbeidsflyter. For AI-agent-arbeidsflyter rapporterer CocoIndex at optimaliserte YAML-konfigurasjoner kan redusere tokenbruk med opptil 70%.
Norge-problemet og andre konverteringsfeller
NO-landskode-feilen
I YAML 1.1 blir nakne strenger som NO, OFF og YES automatisk konvertert til boolske verdier false eller true. TOML unngår dette ved å kreve anførselstegn på alle strenger. Ved konvertering, alltid sett anførselstegn rundt tvetydige verdier i YAML:
| Verdi | YAML 1.1-tolkning | Løsning |
|---|---|---|
NO |
false |
"NO" |
OFF |
false |
"OFF" |
YES |
true |
"YES" |
On |
true |
"On" |
YAML 1.2 (gjeldende spesifikasjon) fikser de fleste av disse tvungne konverteringene, men mange parsere bruker fortsatt 1.1-atferd som standard.
Innrykksfeil
YAML-parsere avviser filer med inkonsekvent innrykk. Vanlige feil:
- Blande tabulatorer og mellomrom (YAML forbyr tabulatorer)
- Bruke 3 mellomrom i én blokk og 2 i en annen
- Misjusterte listeelementer
AI-assistert generering
Verktøy som AgentBuilder lar deg beskrive konfigurasjon i ren engelsk og produsere validert YAML. Denne “beskriv → generer → valider”-syklusen bidrar til å unngå både innrykksfeil og Norge-problemet.
Konklusjon
Bruk yq -oy '.' file.toml for automatisert konvertering. For manuelt arbeid, kartlegg TOML-tabeller til YAML-innrykk, arrays til stiprekse lister, og alltid sett anførselstegn rundt strenger som kan forveksles med boolske verdier. Etter enhver konvertering, valider YAML-utdataene før distribusjon — ett feilplassert mellomrom eller et ukreditert NO kan ødelegge hele pipelinen din.
FAQ
Støtter YAML kommentarer som TOML?
Ja. Begge bruker # for enlinjers kommentarer. YAML-kommentarer kan forstyrre parsing av flerlinjers strenger, så plasser dem på separate linjer ved usikkerhet.
Hva er Norge-problemet i YAML?
I YAML 1.1 blir nakne strenger som NO (Norges landskode) automatisk konvertert til boolsk false. TOML unngår dette ved å kreve anførselstegn på alle strengverdier. Ved konvertering fra TOML til YAML, sett anførselstegn rundt alle potensielt tvetydige strenger.
Hvilket format håndterer dyp nøsting bedre?
YAML. TOML krever gjentakelse av lange headere som [table.subtable.subsubtable] for hvert nivå, noe som blir omstendelig. YAML representerer samme hierarki med innrykk — mer kompakt og lesbart på dypere nivåer.
Legg igjen en kommentar