Vad är filformatet YAML?
.yaml är ett textfilformat som används för att utbyta data mellan olika applikationer. YAML - förkortning för *YAML Ain't Markup Language* - är en standard för att organisera information i ett läsbart, plattformsoberoende format med hjälp av indragningsbaserade key: value-par kodade i UTF-8. Parsning av .yaml-filer kräver att ett YAML-bibliotek är installerat; populära bibliotek inkluderar PyYAML (Python), js-yaml (JavaScript) och SnakeYAML (Java). .yaml-filer sparas ibland med filtillägget .yml, vilket är funktionellt identiskt. Utöver datautbyte används .yaml-filer vanligtvis för att serialisera data och för att skriva konfigurationsfiler i verktyg som Docker Compose, Kubernetes och GitHub Actions.
Serialisering
Serialisering är en term som används inom datavetenskap. Serialisering är en process för att översätta data eller objekt till ett format som kan lagras, överföras och rekonstrueras senare. Till exempel måste två institutioner som utbyter data i ett standardiserat format med hjälp av olika applikationer serialisera den datan innan den skickas. Serialiserad data kan också lagras i en fil - .yaml, .xml, .json, .toml, etc. - och sedan skickas till mottagarna.
Ett .yaml-dokument kan valfritt börja med dokumentstartmarkören --- och sluta med ...; detta tillåter även flera dokument i en enda fil. Sedan YAML 1.2 (2009, reviderad 2021) är varje giltig JSON-fil också giltig YAML.
Säkerhet & trygghet
RISK: MEDIUMEn YAML-fil är klartext och körs inte av sig själv, så det är säkert att läsa en. Två verkliga risker: (1) konfigurations-YAML (CI-pipelines, Compose, K8s, Ansible) innehåller ofta hemligheter - tokens, lösenord, nycklar - så klistra inte in dem i otillförlitliga online-validatorer eller skicka in dem till publika arkiv. (2) Programmatisk fara: att ladda otillförlitlig YAML med en osäker parser (t.ex. PyYAMLs yaml.load istället för yaml.safe_load) kan köra godtyckliga objekt/kod - använd alltid den säkra laddaren för filer du inte litar på. Redigeringsrisk: en tabulator eller ett feljusterat mellanslag ändrar tyst innebörden, så validera efter redigering.
Formatdetaljer
i ett nötskalFULLSTÄNDIGT NAMNYAML Ain't Markup Language file
UTVECKLAREClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)sedan 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
KATEGORIUtvecklarfiler
MIME-TYPapplication/yaml
TYPMänniskoläsbar dataserialiseringstext (indragningsbaserad, UTF-8)
STANDARDÖppen · royaltyfri
Program som öppnar YAML-filer
Windows4 apps
Sublime Text
Freemium Öppna .yaml för snabb redigering med YAML-markering; konfigurera «translate tabs to spaces» så att indragen förblir giltiga. 
Windows Notepad
Inbyggd Öppnar YAML som text för en snabb titt - men den visar inte osynliga tecken/tabulatorer, så det är riskabelt för redigering av indragningskänslig YAML. 
Notepad
Öppen källkod Öppna med YAML-syntaxmarkering; aktivera Visa > Visa symbol > Visa blanksteg för att hålla indragen korrekta. 
Visual Studio Code
Gratis Öppna filen; det inbyggda eller Red Hat YAML-tillägget ger syntaxmarkering, indragningsguider, schemavalidering och felmarkeringar. Bästa valet för YAML. 
macOS3 apps
TextEdit
Inbyggd Välj Format > Gör till ren text först, och inaktivera smarta citattecken - men den visar inte osynliga tecken, så föredra en kodredigerare för redigering.
Visual Studio Code
Gratis Öppna filen; det inbyggda eller Red Hat YAML-tillägget ger syntaxmarkering, indragningsguider, schemavalidering och felmarkeringar. Bästa valet för YAML. 
Sublime Text / BBEdit
Freemium Öppna .yaml i en kodredigerare för korrekt YAML-markering och mellanslagsbaserad indragning. 
Linux3 apps
Visual Studio Code
Gratis Öppna filen; det inbyggda eller Red Hat YAML-tillägget ger syntaxmarkering, indragningsguider, schemavalidering och felmarkeringar. Bästa valet för YAML.
GNOME Text Editor / gedit
Öppen källkod Öppna med YAML-markering; ställ in den på att infoga mellanslag (inte tabulatorer) före redigering.
vim / nano
Öppen källkod Redigera i terminalen; i Vim använd «:set expandtab» så att indrag använder mellanslag. Standard för serverkonfigurationsfiler.
Web1 app
YAML Lint / online YAML validators
Gratis Klistra in filen för att validera syntax och formatera den i webbläsaren. Klistra inte in hemligheter - konfigurations-YAML innehåller ofta inloggningsuppgifter. Tekniska detaljer
djup specifikation| Filtillägg | .yaml (även .yml) |
| MIME-typ | application/yaml |
| Kodning | UTF-8 klartext; ingen binär header eller magic bytes |
| Struktur | Indragningsbaserade key: value-par; indrag använder endast mellanslag - tabulatorer är förbjudna enligt specifikationen |
| Dokumentmarkörer | --- markerar dokumentstart, ... markerar dokumentslut; flera dokument kan finnas i samma fil |
| Inbyggda datatyper | Strängar, heltal, flyttal, booleaner, null, sekvenser (listor), mappningar (lexikon), tidsstämplar |
| Specifikationsversion | YAML 1.2 (2009, reviderad 2021); ersätter YAML 1.1 (2005) och YAML 1.0 (2001) |
| JSON-kompatibilitet | Sedan YAML 1.2 är varje giltigt JSON-dokument också giltig YAML - JSON är en strikt delmängd |
| Kommentarer | Enradskommentarer inleds med # ; kan förekomma på en egen rad eller på samma rad efter ett värde |
| Flerradiga strängar | Literal block scalar (|) bevarar radbrytningar; folded scalar (>) konverterar radbrytningar till mellanslag |
| Ankare och alias | & definierar ett namngivet ankare och * refererar till (alias) det, vilket möjliggör återanvändning av värden utan duplicering |
| Utvecklare | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Vanliga användningsområden | Konfigurationsfiler (Kubernetes, Docker Compose, GitHub Actions, Ansible), dataserialisering, OpenAPI-definitioner |
| Citattecken | Strängar utan citattecken, med enkla citattecken ('...') och dubbla citattecken ("...") stöds; dubbla citattecken tillåter escape-sekvenser |
| Släppt | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Öppen standard | Ja · royaltyfri |
| Specifikation | yaml.org |
YAML-konverteringar
Möjligt
.YAML .JSONOnline-konverterare
Ja - YAML och JSON delar samma datamodell, så konverteringen är förlustfri; endast YAML-kommentarer tas bort.
Hur man konverterar
.YAML .XMLOnline-konverterare
Ja - YAML och XML beskriver båda hierarkiska data, så konverteringen är enkel, även om varje YAML-nyckel blir…
Hur man konverterar
.YAML .TOMLGUIDE
Ja, YAML kan konverteras till TOML -- den snabbaste metoden är ett yq-kommando: yq -o=toml file.yaml >…
Hur man konverterar
.YAML .CSVGUIDE
Ja - men endast när filen .yaml är en platt, enhetlig lista med poster; nästlade konfigurationer som…
Hur man konverterar
.YAML .YMLGUIDE
Ja - .yaml och .yml är samma format; att byta namn på filen är allt du behöver göra.
Hur man konverterar
Inte möjligt
Frågor & svar
frågat av användare
I
Vanliga frågor
Vad är skillnaden mellan .yaml och .yml?
Ingen - de är samma YAML-format med två olika filtillägg. .yml är den äldre formen med tre bokstäver. Använd det som verktyget förväntar sig; du kan helt enkelt döpa om filen.
Hur öppnar jag en .yaml-fil?
Med valfri kod- eller textredigerare. VS Code (med YAML-tillägget) är bäst eftersom den markerar struktur och flaggar indragningsfel; Notepad++ och Sublime fungerar också. Det är klartext, så Notepad kan öppna den - men den visar inte osynliga tecken, vilket YAML är beroende av.
Varför ger min YAML ett indragnings- eller parsningsfel?
YAML använder mellanslag för struktur och förbjuder tabulatorer, så en felaktig tabulator eller en feljusterad rad förstör den. Öppna den i en YAML-medveten redigerare (visa osynliga tecken, konvertera tabulatorer till mellanslag) eller klistra in den i en YAML-validator online för att hitta den exakta raden.
Hur konverterar jag YAML till JSON?
Använd «yq -o=json file.yaml», ett kommando i VS Code eller en online-konverterare. Det är i princip förlustfritt eftersom JSON är en delmängd av YAML - endast kommentarer tas bort.
Kan jag använda tabulatorer i YAML?
Nej. YAML tillåter endast mellanslag för indrag; tabulatorer orsakar ett parsningsfel. Ställ in din redigerare på att infoga mellanslag (t.ex. «:set expandtab» i Vim, eller «translate tabs to spaces» i Sublime).
Är YAML bara för Python?
Nej - det är en vanlig missuppfattning. YAML är språkoberoende och används överallt: Docker Compose, Kubernetes, GitHub Actions, Ansible, Go/Java/JS-appar med mera. Python råkar bara ha ett populärt YAML-bibliotek (PyYAML).
Referenser
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
