# Markdown frontmatter: lägg sidmetadata i din text

*16 november 2026*

> Frontmatter är YAML-blocket överst i en Markdown-fil som lagrar titel, datum och taggar för sidan. Så här skriver du det rätt och använder det vid publicering.

## Vad är Markdown frontmatter?

Frontmatter, eller YAML-frontmatter, är ett metadata-block som placeras överst i en Markdown-fil. Blocket börjar med tre bindestreck (---) på en egen rad, slutar med samma tecken på en egen rad, och däremellan står metadata i YAML-format: nyckel, kolon, värde. Inget av det som står i frontmatter-blocket visas som vanlig brödtext på den publicerade sidan.

Blocket kallas också för sidmetadata, headermetadata eller YAML-header. Det är inte en del av Markdown-språket i sig, utan ett tillägg som publiceringsverktyg och statiska webbplatsgeneratorer har tagit i bruk för att veta vad en sida heter, när den publicerades och vilka taggar den tillhör.

Markdown i sig är ett lättviktigt sätt att formatera text — rubriker, listor, länkar och fetstil — utan att behöva koda HTML. Du kan läsa mer om Markdown på Wikipedia: https://sv.wikipedia.org/wiki/Markdown

## Vilka fält brukar finnas i frontmatter?

Det finns inga obligatoriska fält. Verktyget som publicerar sidan bestämmer vad det läser. De vanligaste fälten är:

- title — sidans titel, till exempel "Om oss" eller "Arbeta hos oss."
- date — publiceringsdatum, ofta i formatet åååå-mm-dd.
- tags — en lista med taggar som används för att sortera och filtrera sidor.
- author — skribent eller upphovsperson.
- layout — vilken mall sidan ska renderas med.
- draft — om sidan är ett utkast och inte ska publiceras än.
- description — en kort beskrivning som kan visas i sökresultat eller i en förhandsvisning.

Ett exempel på ett fullständigt block:

---
title: Om oss
date: 2026-11-16
tags: [företag, om oss]
author: Linnea
layout: page
draft: false
description: Vårt företag och vad vi gör.
---

Varje fält är valfritt. Ta med bara de fält som ditt verktyg faktiskt använder.

## Så skriver du frontmatter steg för steg

Frontmatter måste stå överst i filen, annars ignoreras det av de flesta verktyg. Så här gör du:

1. Skriv --- på första raden i filen. Inget får stå före det, inte ens ett mellanslag eller en tom rad.
2. Skriv dina metadatafält under, ett per rad, i formatet nyckel: värde.
3. Avsluta blocket med en egen rad som innehåller bara ---.
4. Lämna en tom rad efter det avslutande ---.
5. Skriv vanlig Markdown-brödtext nedanför.
6. Spara filen med ändelsen .md.

Ett fullständigt exempel ser ut så här:

---
title: Publicera en sida med Markdown
date: 2026-11-16
tags: [markdown, publicering]
---

# Publicera en sida med Markdown

Det här är brödtexten som läsaren ser. Frontmatter-blocket ovanför bestämmer sidans titel och datum, men det syns inte i brödtexten.

Tre saker att tänka på:

- Bindestrecken --- måste vara det första på raden. Ett steg för mycket i indrag förstör blocket.
- Använd citationstecken runt värden som innehåller kolon, citattecken eller svenska tecken, till exempel title: "Så här & så".
- Ha bara ett frontmatter-block per fil. Ett andra block längre ned i dokumentet behandlas som vanlig text.

## Hur publiceringsverktyget använder frontmatter

När du klistrar in din Markdown och får en live-länk läser verktyget av frontmatter-blocket först. Titel-fältet blir ofta sidans titel i webbläsarfliken och i rubriken över sidan. Datum-fältet sparas som publiceringsdatum och kan användas för att sortera sidor nyast först. Taggarna kan bli klickbara filter eller sidor som samlar allt som är märkt med samma ord.

Brödtexten under blocket publiceras som vanlig Markdown: rubriker blir rubriker, listor blir listor och länkar blir länkar. Frontmatter påverkar alltså inte hur själva texten ser ut, bara den information som omger den.

Läs mer om hur du skapar vanliga Markdown-element i vår guide om [Markdown-syntax](https://publicering.se/artiklar/markdown-syntax-guide).

## Vanliga misstag med frontmatter

Det vanligaste felet är att placera något före det första ---. Även en osynlig tom rad högst upp kan få verktyget att behandla hela blocket som vanlig text.

Andra vanliga misstag:

- Felaktig indentering under en lista, till exempel under tags. Varje listrad börjar med ett mellanslag och ett bindestreck.
- Svenska tecken eller specialtecken utan citationstecken. title: Om oss går bra, men title: Så här & så behöver citationstecken runt hela värdet.
- Att glömma det avslutande ---. Utan det vet inte verktyget var blocket slutar.
- Att lägga frontmatter mitten i dokumentet. Det måste vara det första som står i filen.
- Att använda HTML-kommentarer istället för frontmatter. Frontmatter är alltid YAML mellan ---rader. HTML-kommentarer fungerar på ett annat sätt och läses inte som metadata av de flesta publiceringsverktyg.

## Frågor och svar om frontmatter

Måste jag använda frontmatter?

Nej. Det är helt frivilligt. En Markdown-fil fungerar utmärkt utan något metadata-block alls.

Påverkar frontmatter vad läsaren ser på sidan?

Inte brödtexten. Fälten i blocket används av publiceringsverktyget, inte visats som en del av artikeln.

Kan jag använda HTML istället för frontmatter?

Nej. Frontmatter är alltid YAML mellan ---rader. HTML-kommentarer fungerar på ett annat sätt och läses inte som metadata av de flesta publiceringsverktyg.

Fungerar frontmatter i alla Markdown-verktyg?

Många verktyg och statiska webbplatsgeneratorer stödjer det, men inte alla. Kontrollera dokumentationen för det verktyg du använder.

Vad händer om jag gör ett fel i frontmatter?

Vanligast är att verktyget ignorerar blocket och publicerar sidan utan sidmetadata, eller att det visar ett felmeddelande. Brödtexten publiceras som vanligt oavsett.
