Markdown forklart på 5 minutter
Du har sannsynligvis brukt Markdown uten å vite det. Har du noen gang skrevet **fet** i en Slack-melding? Skrevet en README på GitHub? Formatert et Reddit-innlegg? Det er Markdown.
Markdown er en lettvekts måte å formatere ren tekst på ved hjelp av enkle symboler. I stedet for å klikke på verktøylinjeknapper for fet, kursiv, overskrifter og lister, skriver du noen tegn som angir formateringen du ønsker. Det ble laget i 2004 av John Gruber og Aaron Swartz, og har siden blitt standardformateringsspråket for utviklere, skribenter og alle som jobber med tekst på nettet.
Hvorfor Markdown finnes
Før Markdown betydde tekstformatering for nettet å skrive HTML. For å gjøre et ord fet, måtte du skrive <strong>fet</strong>. For å lage en liste trengte du <ul><li>element</li></ul>. HTML er kraftig, men ordrik og vanskelig å lese i rå form.
Markdown løser dette ved å gi en menneskelig-lesbar forkortelse. Rå tekst er lett å lese selv før den gjengis. Det formaterte resultatet er rent og profesjonelt. Du får det beste fra begge verdener: lesbar kildetekst og polert resultat.
Visste du? Markdowns designfilosofi er at rå tekst skal være «publiserbar som den er, som ren tekst, uten å se ut som om den er markert med tagger eller formateringsinstruksjoner». Det er derfor Markdown-syntaksen bruker tegn som visuelt antyder den formateringen de produserer.
Den viktigste syntaksen
Her er alt du trenger å vite for å begynne å bruke Markdown produktivt.
Overskrifter
Bruk skigntegn (#) for å lage overskrifter. Flere skigntegn betyr mindre overskrifter.
# Overskrift 1 (størst)
## Overskrift 2
### Overskrift 3
#### Overskrift 4
Fet og kursiv
Pakk tekst inn i stjerner eller understrek:
**fet tekst**
*kursiv tekst*
***fet og kursiv***
Lister
Uordnede lister bruker bindestreker, stjerner eller plusstegn. Ordnede lister bruker tall.
- Første element
- Andre element
- Tredje element
1. Første steg
2. Andre steg
3. Tredje steg
Lenker
Hakeparenteser for teksten, vanlige parenteser for URL-en:
[Klikk her](https://example.com)
Bilder
Som lenker, men med et utropstegn foran:
Blokksitering
Bruk et større-enn-tegn:
> Dette er et sitat. Det vil bli rykket inn og stilet annerledes.
Kode
Backticks for innebygd kode, tre backticks for kodeblokker:
Bruk `print()`-funksjonen for å skrive ut tekst.
For flerlinjes kodeblokker, bruk tre backticks med en valgfri språkidentifikator:
```python
def hei():
print("Hei, verden!")
```
Horisontale skillelinjer
Tre eller flere bindestreker, stjerner eller understreker:
---
Tabeller
Bruk rørtegn og bindestreker:
| Navn | Rolle | Sted |
| --- | --- | --- |
| Alice | Utvikler | Berlin |
| Bob | Designer | London |
Hvor Markdown brukes
Markdown er overalt:
Programvareutvikling
- GitHub, GitLab, Bitbucket: README-filer, saker, pull requests og dokumentasjon er alle skrevet i Markdown.
- Stack Overflow: Spørsmål og svar bruker Markdown-formatering.
- Kodedokumentasjon: Mange dokumentasjonsgeneratorer (Docusaurus, MkDocs, Jekyll) bruker Markdown som kildeformat.
Kommunikasjon
- Slack: Støtter et delsett av Markdown for meldingsformatering.
- Discord: Bruker Markdown for fet, kursiv, kodeblokker og mer.
- Reddit: Innlegg og kommentarer er formatert med Markdown.
Skriving og publisering
- Blogger: Mange statiske nettstedsgeneratorer bruker Markdown-filer som innholdskilder.
- Bøker: Flere publiseringsverktøy godtar Markdown-manuskripter.
- Notater: Apper som Obsidian, Notion, Bear og Typora er bygget rundt Markdown.
Dokumentasjon
- Teknisk dokumentasjon: API-dokumentasjon, brukerveiledninger og wikier bruker vanligvis Markdown.
- Interne kunnskapsbaser: Mange team bruker Markdown-baserte wikier.
Tips Du kan forhåndsvise og øve på Markdown akkurat nå, gratis, i nettleseren din: Skriv i Markdown. Se det formaterte resultatet i sanntid mens du skriver.
Markdown-varianter
Én ting å vite: det finnes ulike «varianter» av Markdown. Kjerne-syntaksen er den samme overalt, men noen plattformer legger til utvidelser:
| Variant | Ekstra funksjoner | Brukt av |
|---|---|---|
| CommonMark | Streng spesifikasjon | Generell standard |
| GitHub Flavored Markdown (GFM) | Oppgavelister, tabeller, gjennomstreking, auto-lenking | GitHub |
| MultiMarkdown | Fotnoter, referanser, metadata | Akademisk skriving |
| R Markdown | Innebygd R-kode, dataanalyse | Datavitenskap |
Forskjellene gjelder stort sett avanserte funksjoner. Det grunnleggende (overskrifter, fet, kursiv, lister, lenker, bilder, kode) fungerer likt overalt.
Vanlige feil
Å glemme tomme linjer
Markdown krever en tom linje før og etter mange elementer. En overskrift trenger en tom linje foran. En liste trenger en tom linje foran og etter. Å glemme disse tomme linjene er den vanligste kilden til gjengivelsesproblemer.
Inkonsistente listemarkører
Å blande -, * og + i samme liste kan gi uventet gjengivelse. Velg én og hold deg til den.
Mellomrom etter symboler
Noen Markdown-prosessorer krever et mellomrom etter # i overskrifter og etter - i lister. Inkluder alltid mellomrommet for sikkerhets skyld.
# Riktig overskrift
#Feil overskrift
- Riktig listeelement
-Feil listeelement
Advarsel Markdown støtter ikke alle formateringsbehov. Hvis du trenger komplekse oppsett, farget tekst, presis typografi eller utskriftsklare dokumenter, kan det hende du trenger HTML, LaTeX eller et tekstbehandlingsprogram. Markdown er best for strukturert, tekstfokusert innhold.
Hvorfor Markdown er verdt å lære
Markdown tar fem minutter å lære og sparer timer over tid. Når du kan det, kan du:
- Skrive dokumentasjon som ser flott ut på GitHub
- Formatere meldinger i Slack og Discord uten å røre musen
- Ta strukturerte notater som er bærbare på tvers av apper
- Lage blogginnlegg og nettinnhold fra rene tekstfiler
- Samarbeide om tekstbaserte dokumenter uten formatkompatibilitetsproblemer
Investerings-til-avkastning-forholdet er ett av de beste i hele teknologiverdenen.
Begynn å skrive i Markdown akkurat nå:
Gratis, i nettleseren din, med sanntids forhåndsvisning mens du skriver.