Markdown-fusklapp: GitHub-syntax med exempel

Markdown är det enklaste sättet att skriva formaterad text som fortfarande går att läsa som vanlig text. README-filer, dokumentation, anteckningar, chattmeddelanden och statiska webbplatser använder det. Den här fusklappen går igenom den syntax du faktiskt kommer att använda, med fokus på GitHub-Flavored Markdown (GFM) – dialekten som stöds av GitHub, GitLab, de flesta dokumentationsverktyg och Markdown Preview Editor.

Alla exempel nedan kan klistras in i onlineredigeraren så att du ser resultatet sida vid sida.

Rubriker

Börja en rad med ett till sex #-tecken följda av ett mellanslag. Ett # är sidans titel, ## ett avsnitt, ### ett underavsnitt.

markdown# Sidans titel
## Avsnitt
### Underavsnitt
#### Mindre rubrik

Ha bara en #-rubrik per dokument och hoppa inte över nivåer (till exempel direkt från ## till ####). Skärmläsare och sökmotorer använder rubrikstrukturen för att förstå sidan, och de flesta förhandsvisningsverktyg bygger en innehållsförteckning utifrån den.

Stycken och radbrytningar

Ett stycke är en eller flera textrader som skiljs från nästa stycke av en tom rad. En enkel radbrytning inuti ett stycke ignoreras – raderna slås ihop. För att tvinga fram en radbrytning avslutar du raden med två mellanslag eller ett omvänt snedstreck:

markdownFörsta raden med två avslutande mellanslag  
Andra raden i samma stycke.

Ett nytt stycke börjar efter en tom rad.

Betoning

Många redigerare, däribland Markdown Preview Editor, stöder dessutom några populära tillägg: ==markering==, H~2~O för nedsänkt text, x^2^ för upphöjd text och emoji-koder i stil med :smile:. De ingår inte i själva GFM, så kontrollera din målplattform innan du förlitar dig på dem.

Listor

Använd -, * eller + för punktlistor och siffror för numrerade listor. Dra in två till fyra mellanslag för att skapa underpunkter.

markdown- Mjölk
- Bröd
  - Fullkorn
  - Råg
- Kaffe

1. Klona repot
2. Installera beroenden
3. Kör bygget

Numrerade listor behöver inte rätt siffror – 1. på varje rad visas ändå som 1, 2, 3. Börjar du med en annan siffra (till exempel 5.) startar listan där.

Uppgiftslistor

Uppgiftslistor är ett GFM-tillägg som gör listpunkter till kryssrutor. De passar perfekt i README-filer, releaseplaner och mötesanteckningar.

markdown- [x] Skriv utkastet
- [x] Lägg till skärmbilder
- [ ] Publicera inlägget

Länkar

markdown[Länktext](https://example.com)
[Länk med titel](https://example.com "Visas när du hovrar")
<https://example.com>

Läs [installationsguiden][install].

[install]: https://example.com/docs/install

Den sista formen är en referenslänk: adressen definieras en gång längst ner i dokumentet, vilket gör långa stycken lättare att läsa. Relativa länkar som [Setup](docs/setup.md) pekar på andra filer i samma projekt; i Markdown Preview Editor byter de till det dokumentet om det är öppet i en annan flik.

Bilder

Bilder använder länksyntax med ett utropstecken framför. Texten inom hakparenteser är alternativtexten – beskriv bilden för dem som inte kan se den.

markdown![Redigerare med förhandsvisning i realtid](images/screenshot.png)
![Logotyp](https://example.com/logo.svg "Valfri titel")

När du förhandsvisar ett dokument som hänvisar till lokala bilder ska du öppna hela mappen eller släppa bilderna tillsammans med .md-filen, så att verktyget kan hitta de relativa sökvägarna.

Kod

Kod i löptext omges av enkla bakåtfnuttar. För kodblock omsluter du koden med tre bakåtfnuttar och anger språkets namn för syntaxmarkering:

markdown```js
function greet(name) {
  return `Hello, ${name}!`;
}
```

Vanliga språknamn: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Om själva koden innehåller tre bakåtfnuttar omsluter du den med fyra, som i exemplet ovan.

Tabeller

Skilj kolumnerna åt med lodstreck och lägg en rad med bindestreck under rubrikraden. Kolon i avgränsningsraden styr justeringen.

markdown| Funktion        | Gratis | Kommentar                 |
|:----------------|:------:|--------------------------:|
| Förhandsvisning |   ✅   | Uppdateras när du skriver |
| Export          |   ✅   | HTML, PDF, .md            |

:--- vänsterjusterar, :---: centrerar och ---: högerjusterar. Kolumnerna behöver inte linjera i källtexten – men en bra redigerare håller dem läsbara. Markdown Preview Editor har en tabellknapp i verktygsfältet som infogar en färdig mall.

Citat och informationsrutor

Inled rader med > för att citera text. GitHub stöder också informationsrutor (alerts) – citatblock med en särskild första rad som visas som färgade rutor:

markdown> Ett vanligt citat.

> [!NOTE]
> Användbar information som användarna bör känna till.

> [!TIP]
> Praktiska råd för att göra saker bättre.

> [!WARNING]
> Brådskande information som kräver omedelbar uppmärksamhet.

De fem typerna är NOTE, TIP, IMPORTANT, WARNING och CAUTION. Använd dem sparsamt: en ruta per avsnitt sticker ut, fem i rad blir bara brus.

Fotnoter

Fotnoter håller sidokommentarer utanför huvudtexten. Noten kan definieras var som helst; den visas i slutet av dokumentet.

markdownMarkdown skapades 2004.[^1]

[^1]: Av John Gruber, med hjälp av Aaron Swartz.

Horisontella linjer och escape-tecken

Tre eller fler bindestreck, asterisker eller understreck på en egen rad ger en horisontell linje: ---. Lägg en tom rad före, annars gör --- under en textrad den texten till en rubrik.

För att visa ett tecken som Markdown annars skulle tolka sätter du ett omvänt snedstreck framför: \*inte kursiv\*, \# inte en rubrik, \$5 (användbart när formler är aktiverade).

Formler och diagram

Två tillägg har blivit standard inom teknisk dokumentation:

• Formler – $E = mc^2$ för formler i löptext och $$ … $$ för fristående ekvationer. Läs hela guiden om att skriva matematik i Markdown.
• Diagram – ett kodblock med språket mermaid ritar flödesscheman, sekvensdiagram, Gantt-scheman med mera. Se Mermaid-diagram i Markdown.

Front matter

Statiska webbplatsgeneratorer läser metadata från ett YAML-block allra överst i filen:

yaml---
title: Mitt inlägg
date: 2026-09-27
tags: [markdown, docs]
---

Ett bra förhandsvisningsverktyg döljer det här blocket i stället för att visa det som text. Markdown Preview Editor gör precis så.

Vad händer härnäst

Att kunna syntaxen är halva jobbet – den andra halvan är att se resultatet medan du skriver. Läs hur du förhandsvisar Markdown online utan att ladda upp dina filer, och när dokumentet är klart kan du lära dig hur du konverterar Markdown till HTML eller PDF.