JSON naar YAML converter

JSON naar YAML zet gegevens in JSON-notatie om naar een YAML-structuur die prettiger leest in configuratiebestanden. JSON gebruikt accolades, blokhaken, dubbele aanhalingstekens en komma’s. YAML werkt vooral met inspringing, dubbele punten en lijsten met streepjes. Daardoor is YAML vaak overzichtelijker wanneer mensen het bestand regelmatig moeten lezen of aanpassen.

Een eenvoudig JSON-fragment zoals { "stad": "Utrecht", "actief": true } wordt in YAML bijvoorbeeld stad: Utrecht en actief: true op aparte regels. De inhoud blijft hetzelfde, maar de schrijfwijze verandert. Dat is precies waar JSON naar YAML voor bedoeld is: niet om data inhoudelijk te bewerken, maar om dezelfde structuur in een ander gegevensformaat te tonen.

Voor Nederlandse ontwikkelteams is dit handig bij configuratie voor Kubernetes, Docker Compose, GitHub Actions en CI/CD-pipelines. Een API kan bijvoorbeeld JSON teruggeven met instellingen voor een bezorgservice, terwijl het deploymentproces YAML verwacht. Met JSON naar YAML voorkom je handmatig overschrijven en verklein je de kans op fouten door vergeten komma’s of verkeerd geplaatste accolades.

Gebruik bij voorkeur eerst een controle op geldige JSON. Als de invoer al rommelig is, kan JSON netjes opmaken helpen voordat je de omzetting uitvoert.

YAML is vooral sterk wanneer configuratie door mensen wordt onderhouden. Denk aan een team dat in Amsterdam, Eindhoven of Groningen werkt aan dezelfde deploymentbestanden. Een YAML-bestand met duidelijke inspringing is vaak sneller te scannen dan een compact JSON-object met veel accolades. Daardoor zie je sneller welke service bij welke poort, omgevingsvariabele of limiet hoort.

JSON blijft zeer geschikt voor gegevensuitwisseling tussen systemen. API’s, logstromen en browserapplicaties gebruiken JSON omdat het strak gedefinieerd is en breed wordt ondersteund. YAML is losser en leesbaarder, maar daardoor ook gevoeliger voor inspringfouten. Een spatie te weinig kan betekenen dat een sleutel op het verkeerde niveau staat.

Kies JSON naar YAML wanneer de eindbestemming YAML verwacht of wanneer je data uit een JSON-bron wilt gebruiken als startpunt voor een configuratiebestand. Voorbeelden zijn een Kubernetes-manifest, een Docker Compose-configuratie of een workflowbestand voor automatische tests. In zulke situaties wil je niet elk veld handmatig overtypen.

Let wel op dat conversie geen kwaliteitscontrole van je architectuur is. Een onhandige JSON-structuur wordt na omzetting meestal een onhandige YAML-structuur. Het formaat verandert, maar de betekenis en hiërarchie blijven leidend.

JSON naar YAML begint met het parsen van de JSON-invoer. De tool leest objecten, arrays, strings, getallen, booleans en null als datastructuren. Pas daarna wordt de structuur opnieuw uitgeschreven in YAML. Dat betekent dat de tool niet simpelweg tekens vervangt, maar de betekenis van de JSON-boom volgt.

Een object in JSON wordt een verzameling sleutels en waarden in YAML. Een array wordt meestal een lijst met regels die beginnen met een streepje. Geneste objecten krijgen extra inspringing. Zo blijft zichtbaar welke velden bij elkaar horen. Een JSON-array met vestigingen, bijvoorbeeld Rotterdam en Den Haag, wordt in YAML een lijst waarin elke vestiging eigen eigenschappen kan krijgen, zoals naam, postcode en actief.

De omzetting moet ook typen behouden. true blijft een boolean, 42 blijft een getal en null blijft een lege waarde. Strings met speciale tekens kunnen aanhalingstekens nodig hebben, zeker als ze lijken op YAML-sleutelwoorden of datums. Een waarde zoals ja kan in sommige YAML-varianten gevoelig zijn, omdat oudere parsers dit als boolean kunnen interpreteren.

Wil je later de omgekeerde richting op, dan kun je terug naar JSON gaan. Dat is nuttig wanneer een systeem uiteindelijk toch JSON-invoer eist.

Ontwikkelaars gebruiken JSON naar YAML vaak op het moment dat data uit een API moet landen in configuratie. Stel dat een interne API een lijst met services teruggeeft in JSON, met namen, poorten en healthchecks. Voor een deployment in Kubernetes wil je die informatie kunnen verwerken in YAML. De converter levert dan een leesbare basis die je verder kunt aanvullen met labels, resource limits en namespaces.

Data-engineers komen het formaatverschil tegen bij pipelines. Een databron beschrijft velden in JSON, terwijl een orchestrator YAML verwacht voor taken, afhankelijkheden en schema-instellingen. Door JSON naar YAML te gebruiken, kun je de structuur sneller overnemen en daarna domeinspecifieke details toevoegen, zoals batchfrequentie, opslaglocatie of retentiebeleid.

Ook bij migraties is de tool praktisch. Een team kan oude configuratie in JSON hebben, terwijl nieuwe tooling YAML als standaard gebruikt. In plaats van bestand voor bestand handmatig te herschrijven, converteer je eerst de structuur en controleer je daarna de semantiek. Dat bespaart tijd bij projecten met meerdere omgevingen, zoals ontwikkeling, acceptatie en productie.

Wanneer het doel niet YAML maar een ander configuratieformaat is, kan JSON naar TOML beter passen. Dat zie je bijvoorbeeld bij bepaalde buildtools en eenvoudige applicatieconfiguraties.

De meeste conversies zijn rechttoe rechtaan, maar randgevallen verdienen aandacht. Geneste objecten en arrays worden in YAML weergegeven met inspringing. Dat is leesbaar, maar ook streng: één verkeerd niveau kan de betekenis veranderen. Controleer daarom na conversie vooral diep geneste stukken, zoals permissies, routeconfiguratie of lijsten met omgevingsvariabelen.

Speciale tekens vragen om zorgvuldige weergave. Een string met een dubbele punt, hekje, accolade of regeleinde kan in YAML aanhalingstekens nodig hebben. Denk aan een Nederlandse adresregel zoals Straat: Oudegracht of een opmerking met #. Zonder correcte quoting kan YAML denken dat een deel van de tekst een sleutel of commentaar is.

Meerdere regels tekst, zoals een e-mailtemplate of foutmelding voor gebruikers, kunnen in YAML op verschillende manieren worden weergegeven. Een converter kan kiezen voor een blockstijl, waarbij de tekst beter leesbaar blijft, of voor expliciete newline-tekens. Beide kunnen geldig zijn, maar ze lezen anders en sommige systemen verwachten een specifieke vorm.

Conversie is meestal structureel verliesarm, zolang de JSON geldig is en de YAML-output volgens dezelfde datatypen wordt geïnterpreteerd. Toch kunnen details zoals volgorde, quotingstijl en representatie van lange strings verschillen. Test daarom de YAML altijd met de toepassing die het bestand uiteindelijk gebruikt.

Hoe converteer ik JSON naar YAML? Plak geldige JSON in JSON naar YAML en laat de tool de structuur omzetten. Controleer daarna de uitvoer, vooral als je die direct gebruikt in productieconfiguratie. Bij foutmeldingen is de invoer vaak geen geldige JSON, bijvoorbeeld door een ontbrekende komma of een onjuist aanhalingsteken.

Wat zijn de belangrijkste verschillen tussen JSON en YAML? JSON is compacter en gebruikt expliciete leestekens zoals {}, [] en komma’s. YAML gebruikt inspringing en is daardoor prettiger voor configuratie die mensen lezen. JSON is vaak de standaard voor API-verkeer, YAML voor configuratiebestanden.

Wat gebeurt er met geneste structuren? Geneste objecten blijven genest, maar worden weergegeven met extra inspringing. Arrays worden lijsten. Een lijst met Nederlandse provincies of magazijnlocaties blijft dus een lijst, alleen in YAML-notatie.

Is de conversie verliesloos? Voor gewone data meestal wel: strings, getallen, booleans, lijsten en objecten blijven behouden. Niet elk detail van de oorspronkelijke schrijfwijze blijft hetzelfde. JSON-aanhalingstekens, spaties en opmaak verdwijnen omdat YAML een eigen notatie gebruikt.

Kan ik de YAML meteen gebruiken? Vaak wel, maar valideer altijd in het doelprogramma. Kubernetes, Docker Compose en CI/CD-tools kunnen eigen regels of verplichte velden hebben die losstaan van de conversie zelf.