Hva er YAML-filformatet?
.yaml er et tekstfilformat som brukes til å utveksle data mellom ulike applikasjoner. YAML - forkortelse for *YAML Ain't Markup Language* - er en standard for å organisere informasjon i et menneskevennlig, plattformuavhengig format ved bruk av innrykksbaserte key: value-par kodet i UTF-8. Parsing av .yaml-filer krever at et YAML-bibliotek er installert; populære biblioteker inkluderer PyYAML (Python), js-yaml (JavaScript) og SnakeYAML (Java). .yaml-filer lagres noen ganger med filendelsen .yml, som er funksjonelt identisk. Utover datautveksling brukes .yaml-filer vanligvis til serialisering av data og for å skrive konfigurasjonsfiler i verktøy som Docker Compose, Kubernetes og GitHub Actions.
Serialisering
Serialisering er et begrep som brukes i informatikk. Serialisering er en prosess for å oversette data eller objekter til et format som kan lagres, overføres og rekonstrueres senere. For eksempel må to institusjoner som utveksler data i et standardisert format ved hjelp av ulike applikasjoner, serialisere disse dataene før de sendes. Serialiserte data kan også lagres i en fil - .yaml, .xml, .json, .toml, osv. - og deretter sendes til mottakerne.
Et .yaml-dokument kan valgfritt begynne med dokumentstart-markøren --- og slutte med ...; dette tillater også flere dokumenter i én enkelt fil. Siden YAML 1.2 (2009, revidert 2021), er enhver gyldig JSON-fil også gyldig YAML.
Sikkerhet og trygghet
RISIKO: MEDIUMEn YAML-fil er ren tekst og kjører ikke av seg selv, så det er trygt å lese en. To reelle risikoer: (1) konfigurasjons-YAML (CI-pipelines, Compose, K8s, Ansible) inneholder ofte hemmeligheter - tokens, passord, nøkler - så ikke lim den inn i upålitelige online-validatorer eller publiser den offentlig. (2) Programmatisk fare: lasting av upålitelig YAML med en utrygg parser (f.eks. PyYAMLs yaml.load i stedet for yaml.safe_load) kan utføre vilkårlige objekter/kode - bruk alltid den sikre lasteren for filer du ikke stoler på. Redigeringsrisiko: en tabulator eller et feiljustert mellomrom endrer betydningen lydløst, så valider etter redigering.
Formatdetaljer
i et nøtteskallFULLT NAVNYAML Ain't Markup Language file
UTVIKLERClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)siden 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
KATEGORIUtviklerfiler
MIME-TYPEapplication/yaml
TYPEMenneskevennlig tekst for dataserialisering (innrykksbasert, UTF-8)
STANDARDÅpen · royalty-fri
Programmer som åpner YAML-filer
Windows4 apps
Sublime Text
Freemium Åpne .yaml for rask redigering med YAML-utheving; konfigurer «translate tabs to spaces» slik at innrykket forblir gyldig. 
Windows Notepad
Innebygd Åpner YAML som tekst for en rask titt - men den viser ikke mellomrom/tabulatorer, så det er risikabelt for redigering av innrykksfølsom YAML. 
Notepad
Åpen kildekode Åpne med YAML-syntaksutheving; slå på View > Show Symbol > Show White Space for å holde innrykket korrekt. 
Visual Studio Code
Gratis Åpne filen; den innebygde eller Red Hat YAML-utvidelsen gir utheving, innrykksguider, skjema-validering og feilmarkeringer. Det beste valget for YAML. 
macOS3 apps
TextEdit
Innebygd Format > Make Plain Text først, og deaktiver «smart quotes» - men den viser ikke usynlige tegn, så foretrekk en kodeeditor for redigering.
Visual Studio Code
Gratis Åpne filen; den innebygde eller Red Hat YAML-utvidelsen gir utheving, innrykksguider, skjema-validering og feilmarkeringer. Det beste valget for YAML. 
Sublime Text / BBEdit
Freemium Åpne .yaml i en kodeeditor for riktig YAML-utheving og mellomromsbasert innrykk. 
Linux3 apps
Visual Studio Code
Gratis Åpne filen; den innebygde eller Red Hat YAML-utvidelsen gir utheving, innrykksguider, skjema-validering og feilmarkeringer. Det beste valget for YAML.
GNOME Text Editor / gedit
Åpen kildekode Åpne med YAML-utheving; sett den til å sette inn mellomrom (ikke tabulatorer) før redigering.
vim / nano
Åpen kildekode Rediger i terminalen; i Vim bruk «:set expandtab» slik at innrykk bruker mellomrom. Standard for serverkonfigurasjonsfiler.
Web1 app
YAML Lint / online YAML validators
Gratis Lim inn filen for å validere syntaks og formatere den pent i nettleseren. Ikke lim inn hemmeligheter - konfigurasjons-YAML inneholder ofte påloggingsinformasjon. Tekniske detaljer
dyp spesifikasjon| Filendelse | .yaml (også .yml) |
| MIME-type | application/yaml |
| Koding | UTF-8 ren tekst; ingen binær header eller magic bytes |
| Struktur | Innrykksbaserte key: value-par; innrykk bruker kun mellomrom - tabulatorer er forbudt i spesifikasjonen |
| Dokumentmarkører | --- markerer dokumentstart, ... markerer dokument-slutt; flere dokumenter kan eksistere i én fil |
| Innfødte datatyper | Strenger, heltall, flyttall, boolske verdier, null, sekvenser (lister), mappinger (ordbøker), tidsstempler |
| Spesifikasjonsversjon | YAML 1.2 (2009, revidert 2021); erstatter YAML 1.1 (2005) og YAML 1.0 (2001) |
| JSON-kompatibilitet | Siden YAML 1.2 er ethvert gyldig JSON-dokument også gyldig YAML - JSON er en streng delmengde |
| Kommentarer | Enlinjes kommentarer introduseres med # ; kan stå på egen linje eller på samme linje etter en verdi |
| Flerlinje-strenger | Literal block scalar (|) bevarer linjeskift; folded scalar (>) konverterer linjeskift til mellomrom |
| Ankere og aliaser | & definerer et navngitt anker og * refererer (aliaser) til det, noe som muliggjør gjenbruk av verdier uten duplisering |
| Utviklere | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Vanlige bruksområder | Konfigurasjonsfiler (Kubernetes, Docker Compose, GitHub Actions, Ansible), dataserialisering, OpenAPI-definisjoner |
| Anførselstegn | Strenger uten anførselstegn, med enkle ('...') og doble («...») anførselstegn støttes; doble tillater escape-sekvenser |
| Utgitt | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Åpen standard | Ja · royalty-fri |
| Spesifikasjon | yaml.org |
YAML-konverteringer
Mulig
.YAML .JSONGUIDE
Ja - YAML og JSON deler samme datamodell, så konverteringen er tapsfri; bare YAML-kommentarer blir fjernet.
Hvordan konvertere
.YAML .XMLGUIDE
Ja - YAML og XML beskriver begge hierarkiske data, så konvertering er rett frem, selv om hver YAML-nøkkel…
Hvordan konvertere
.YAML .TOMLGUIDE
Ja, YAML kan konverteres til TOML - den raskeste metoden er en yq-kommando: yq -o=toml file.yaml > file.toml.
Hvordan konvertere
.YAML .CSVGUIDE
Ja - men bare når .yaml-filen er en flat, ensartet liste med poster; nøstede konfigurasjoner som…
Hvordan konvertere
.YAML .YMLGUIDE
Ja - .yaml og .yml er samme format; å gi filen nytt navn er alt du trenger å gjøre.
Hvordan konvertere
Ikke mulig
Spørsmål og svar fra fellesskapet
spurt av brukere
I
Ofte stilte spørsmål
Hva er forskjellen mellom .yaml og .yml?
Ingen - de er det samme YAML-formatet med to ulike filendelser. .yml er den eldre formen med tre bokstaver. Bruk det verktøyet forventer; du kan enkelt gi filen nytt navn.
Hvordan åpner jeg en .yaml-fil?
Med hvilken som helst kode- eller teksteditor. VS Code (med YAML-utvidelsen) er best fordi den fremhever strukturen og markerer innrykksfeil; Notepad++ og Sublime fungerer også. Det er ren tekst, så Notepad åpner den - men den vil ikke vise usynlige tegn (whitespace), som YAML er avhengig av.
Hvorfor gir min YAML en innrykks- eller parse-feil?
YAML bruker mellomrom for struktur og forbyr tabulatorer, så en enslig tab eller en feiljustert linje ødelegger den. Åpne den i en YAML-bevisst editor (vis usynlige tegn, konverter tabulatorer til mellomrom) eller lim den inn i en online YAML-validator for å finne den nøyaktige linjen.
Hvordan konverterer jeg YAML til JSON?
Bruk «yq -o=json file.yaml», en VS Code-kommando, eller en online-konverter. Det er i hovedsak tapsfritt siden JSON er en delmengde av YAML - bare kommentarer blir fjernet.
Kan jeg bruke tabulatorer i YAML?
Nei. YAML tillater kun mellomrom for innrykk; tabulatorer forårsaker en parse-feil. Still inn editoren din til å sette inn mellomrom (f.eks. «:set expandtab» i Vim, eller «translate tabs to spaces» i Sublime).
Er YAML bare for Python?
Nei - det er en vanlig misforståelse. YAML er språkuavhengig og brukes overalt: Docker Compose, Kubernetes, GitHub Actions, Ansible, Go/Java/JS-apper og mer. Python har tilfeldigvis et populært YAML-bibliotek (PyYAML).
Referanser
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
