Wat betekent YAML frontmatter? Uitleg met voorbeelden

Als je met markdown werkt voor een website, kom je er vroeg of laat tegenaan: een blok tussen drie streepjes bovenaan je bestand. Dat is YAML frontmatter. We gebruiken het dagelijks voor onze eigen content en in de systemen die we bouwen. In dit artikel leggen we uit wat het is, hoe het werkt en waarom je het wilt gebruiken.

Wat is YAML frontmatter precies?

YAML frontmatter is een blok metadata bovenaan een markdown bestand, ingesloten tussen twee regels met drie streepjes (---). Het bevat gestructureerde informatie over het document zelf: de titel, publicatiedatum, auteur, tags en meer.

Een simpel voorbeeld:

---
title: "Mijn eerste blogpost"
slug: "mijn-eerste-blogpost"
publishedAt: 2026-03-19
author: "Emiel Kolk"
tags: ["marketing", "ai"]
draft: false
---

Alles tussen die twee --- regels is de frontmatter. Alles eronder is de daadwerkelijke content van je pagina. Het format heet YAML (afkorting van "YAML Ain't Markup Language"), een leesbare manier om data te structureren met key-value paren.

Frontmatter vs. content

De frontmatter beschrijft je pagina (metadata). De markdown eronder is wat de bezoeker te zien krijgt. Je CMS of static site generator leest de frontmatter uit om te bepalen hoe de pagina wordt weergegeven, gesorteerd en gevonden.

Hoe werkt de YAML syntax?

YAML werkt met simpele regels. Je schrijft een sleutel, gevolgd door een dubbele punt en een waarde. Elk paar staat op een eigen regel. Er zijn een paar datatypen die je regelmatig tegenkomt.

Tekst (strings):

title: "Wat betekent YAML frontmatter?"
author: "Emiel Kolk"

Aanhalingstekens zijn technisch niet altijd nodig, maar ze voorkomen problemen bij speciale tekens zoals dubbele punten of hashtags in je tekst.

Datums:

publishedAt: 2026-03-19

Datums schrijf je in het formaat YYYY-MM-DD. De meeste frameworks herkennen dit automatisch als datum.

Booleans (waar/onwaar):

draft: false
featured: true

Lijsten (arrays):

tags: ["ai", "marketing", "content"]

Of op meerdere regels:

tags:
  - ai
  - marketing
  - content

Geneste objecten:

seo:
  title: "SEO titel"
  description: "Meta description voor zoekmachines"
  keywords: ["keyword-1", "keyword-2"]

Let op de inspringing met spaties (geen tabs). YAML is gevoelig voor witruimte. Twee spaties per niveau is de standaard.

Profiel

Over de auteur

Emiel Kolk

Ondernemer & Growth Marketeer

Emiel is gespecialiseerd in Growth Automation. Hij verkocht zijn SaaS bedrijf aan Leadinfo. Hij haalde meer dan 16.000 MKB bedrijven binnen, zonder er één handmatig te benaderen: 95% geautomatiseerd, 100% persoonlijke touch.

Welke velden gebruik je in frontmatter?

Welke velden je gebruikt hangt af van je platform en wat je nodig hebt. Maar er zijn patronen die je overal terugziet.

Stel, je bent contentmanager bij een marketingbureau. Je beheert een blog met artikelen voor 6 verschillende klanten, elk in een eigen categorie. Je frontmatter zou er zo uit kunnen zien:

---
title: "5 manieren om je conversieratio te verhogen"
slug: "conversieratio-verhogen"
description: "Praktische tips om meer bezoekers om te zetten in klanten."
publishedAt: 2026-03-15
tags: ["conversie", "optimalisatie", "cro"]
category: "growth"
author: "Lisa de Vries"
draft: false
featured: true
coverImage: "blog/conversie-tips-header"
seo:
  title: "Conversieratio verhogen: 5 bewezen methodes"
  description: "Praktische tips om meer bezoekers om te zetten in klanten."
  keywords: ["conversieratio verhogen", "cro tips"]
---

De velden doen het volgende:

title: de kop van je pagina, ook gebruikt als H1
slug: het URL-pad (/blog/conversieratio-verhogen)
description: de meta description voor zoekmachines (150 tot 160 tekens)
publishedAt: publicatiedatum, bepaalt de volgorde in je bloglijst
tags: labels om content te filteren en te groeperen
category: de hoofdcategorie voor navigatie
author: wie het artikel schreef
draft: staat op true zolang het artikel nog niet klaar is
featured: markeer je artikel als uitgelicht op de homepagina
coverImage: de header-afbeelding (vaak een Cloudinary ID of URL)
seo: een genest object met specifieke SEO-instellingen

Niet elk veld is verplicht. De meeste frameworks vereisen minimaal een title. Alles daaromheen is configuratie die je zelf opbouwt naar behoefte.

Waar wordt YAML frontmatter voor gebruikt?

YAML frontmatter is de standaard in het ecosysteem van static site generators en moderne contentplatformen. Enkele toepassingen:

Static site generators zoals Nuxt Content, Astro, Hugo en Jekyll lezen frontmatter om pagina's te genereren. De frontmatter bepaalt de URL, de template, de sortering en de metadata.

Headless CMS platformen zoals Contentlayer en Keystatic gebruiken frontmatter als schema voor je content. Je definieert welke velden beschikbaar zijn, en de frontmatter in elk bestand volgt dat schema.

Documentatieplatformen zoals VitePress en Docusaurus gebruiken frontmatter voor navigatiestructuur, sidebars en zoekmachineoptimalisatie.

AI en content pipelines zijn een nieuwere toepassing. We gebruiken frontmatter bijvoorbeeld om een aiSummary veld toe te voegen, een beknopte, feitelijke samenvatting die AI-zoekmachines helpt om de kern van een artikel te begrijpen. We schreven hier meer over in onze gids over het bouwen van Claude Skills, waar we laten zien hoe je gestructureerde instructies opzet voor AI-assistenten. Frontmatter speelt ook een rol in CLAUDE.md als systeemprompt.

Stel je voor: je runt een contentteam van 4 personen. Jullie publiceren wekelijks 3 artikelen op een Nuxt-website. Zonder frontmatter zou je metadata handmatig in een database moeten bijhouden, of erger, in losse spreadsheets. Met frontmatter zit alle informatie in het bestand zelf. Elke editor opent het markdown bestand, ziet direct de status, de auteur en de SEO-instellingen, en kan meteen aan de slag. Geen context switching, geen losse systemen.

Hoe begin je met YAML frontmatter?

Als je nog niet eerder met frontmatter hebt gewerkt, is het opstarten eenvoudig.

Stap 1: maak een markdown bestand aan. Noem het bijvoorbeeld mijn-post.md.

Stap 2: voeg frontmatter toe. Begin met de drie streepjes, schrijf je velden, en sluit af met drie streepjes:

---
title: "Mijn eerste post"
slug: "mijn-eerste-post"
publishedAt: 2026-03-19
draft: true
---

Stap 3: schrijf je content eronder. Alles na het afsluitende --- is je reguliere markdown.

Stap 4: valideer je YAML. Veelvoorkomende fouten zijn verkeerde inspringing, ontbrekende aanhalingstekens bij speciale tekens, of tabs in plaats van spaties. De meeste code-editors (VS Code, Cursor) markeren YAML-fouten automatisch.

Wil je zien hoe dit er in de praktijk uitziet bij een groter project? In ons artikel over het verschil tussen Claude Skills en Agents gebruiken we frontmatter om elk artikel automatisch te classificeren, te taggen en vindbaar te maken voor zowel bezoekers als AI-systemen.

Veelgemaakte fout

Gebruik geen tabs voor inspringing in YAML. Alleen spaties werken. De meeste editors kun je instellen op "spaties bij tab", maar controleer dit als je YAML-fouten krijgt die je niet kunt verklaren.

Veelgestelde vragen

Conclusie

YAML frontmatter is een van die concepten die simpel aanvoelt zodra je het begrijpt, maar essentieel is voor hoe moderne websites met content omgaan. Het geeft structuur aan je markdown bestanden, maakt content doorzoekbaar en sorteerbaar, en houdt metadata bij de content waar die hoort.

Of je nu een blog beheert, documentatie schrijft of een contentpipeline bouwt met AI, frontmatter is het startpunt. Begin met een paar basisvelden, en bouw uit wanneer je merkt dat je meer nodig hebt.