Markdown forklaret på 5 minutter
Du har sikkert brugt Markdown uden at vide det. Har du nogensinde skrevet **fed** i en Slack-besked? Skrevet en README på GitHub? Formateret et Reddit-opslag? Det er Markdown.
Markdown er en letvægts måde at formatere ren tekst på ved hjælp af simple symboler. I stedet for at klikke på knapper i en værktøjslinje for fed, kursiv, overskrifter og lister, skriver du et par tegn, der angiver den ønskede formatering. Det blev skabt i 2004 af John Gruber og Aaron Swartz, og er siden blevet standardformateringssproget for udviklere, forfattere og alle, der arbejder med tekst på nettet.
Hvorfor Markdown eksisterer
Inden Markdown betød tekstformatering til nettet, at man skulle skrive HTML. For at gøre et ord fed skulle man skrive <strong>fed</strong>. For at oprette en liste krævede det <ul><li>punkt</li></ul>. HTML er kraftfuldt, men ordigt og svært at læse i rå form.
Markdown løser dette ved at tilbyde en menneskelæselig stenografi. Den rå tekst er let at læse, selv inden den renderes. Det formaterede output er rent og professionelt. Du får det bedste fra begge verdener: læsbar kildetekst og poleret output.
Vidste du? Markdowns designfilosofi er, at den rå tekst bør kunne "udgives som den er, som ren tekst, uden at se ud som om den er markeret op med tags eller formateringsinstruktioner." Det er grunden til, at Markdown-syntaks bruger tegn, der visuelt antyder den formatering, de producerer.
Den grundlæggende syntaks
Her er alt, du behøver for at begynde at bruge Markdown produktivt.
Overskrifter
Brug havelågetegn (#) til at oprette overskrifter. Flere havelågetegn giver mindre overskrifter.
# Overskrift 1 (størst)
## Overskrift 2
### Overskrift 3
#### Overskrift 4
Fed og kursiv
Omslut tekst med asterisker eller understregninger:
**fed tekst**
*kursiv tekst*
***fed og kursiv***
Lister
Uordnede lister bruger bindestreger, asterisker eller plusser. Ordnede lister bruger tal.
- Første punkt
- Andet punkt
- Tredje punkt
1. Første trin
2. Andet trin
3. Tredje trin
Links
Firkantede parenteser til teksten, parenteser til URL'en:
[Klik her](https://example.com)
Billeder
Som links, men med et udråbstegn foran:
Blokcitater
Brug et større-end-tegn:
> Dette er et citat. Det vil blive indrykket og stilet anderledes.
Kode
Backticks til inline-kode, tre backticks til kodeblokke:
Brug `print()`-funktionen til at udskrive tekst.
For flerlinjes kodeblokke, brug tre backticks med et valgfrit sprogid:
```python
def hej():
print("Hej, verden!")
```
Vandrette regler
Tre eller flere bindestreger, asterisker eller understregninger:
---
Tabeller
Brug lodstreger og bindestreger:
| Navn | Rolle | Placering |
| --- | --- | --- |
| Alice | Udvikler | Berlin |
| Bob | Designer | London |
Hvor Markdown bruges
Markdown er overalt:
Softwareudvikling
- GitHub, GitLab, Bitbucket: README'er, issues, pull requests og dokumentation er alle skrevet i Markdown.
- Stack Overflow: Spørgsmål og svar bruger Markdown-formatering.
- Kodedokumentation: Mange dokumentationsgeneratorer (Docusaurus, MkDocs, Jekyll) bruger Markdown som kildeformat.
Kommunikation
- Slack: Understøtter en delmængde af Markdown til beskedformatering.
- Discord: Bruger Markdown til fed, kursiv, kodeblokke og mere.
- Reddit: Opslag og kommentarer formateres med Markdown.
Skrivning og publicering
- Blogs: Mange statiske sitegeneratorer bruger Markdown-filer som indholdskilder.
- Bøger: Adskillige publiceringsværktøjer accepterer Markdown-manuskripter.
- Noter: Apps som Obsidian, Notion, Bear og Typora er bygget op om Markdown.
Dokumentation
- Teknisk dokumentation: API-dokumentation, brugervejledninger og wikier bruger ofte Markdown.
- Interne vidensbanker: Mange teams bruger Markdown-baserede wikier.
Tip Du kan forhåndsvise og øve Markdown nu — gratis i din browser: Skriv i Markdown. Se dit formaterede output i realtid, mens du skriver.
Markdown-varianter
Én ting at vide: der findes forskellige "varianter" af Markdown. Kernesyntaksen er den samme overalt, men nogle platforme tilføjer udvidelser:
| Variant | Ekstra funktioner | Bruges af |
|---|---|---|
| CommonMark | Streng specifikation | Generel standard |
| GitHub Flavored Markdown (GFM) | Opgavelister, tabeller, gennemstregning, auto-linking | GitHub |
| MultiMarkdown | Fodnoter, citater, metadata | Akademisk skrivning |
| R Markdown | Indlejret R-kode, dataanalyse | Data science |
Forskellene er primært i avancerede funktioner. Det grundlæggende (overskrifter, fed, kursiv, lister, links, billeder, kode) fungerer ens overalt.
Typiske fejl
Glemmer blanke linjer
Markdown kræver en blank linje før og efter mange elementer. En overskrift har brug for en blank linje foran. En liste har brug for en blank linje foran og bagved. At glemme disse blanke linjer er den mest almindelige kilde til renderingsproblemer.
Inkonsistente listemærker
At blande -, * og + i samme liste kan føre til uventet rendering. Vælg ét og hold dig til det.
Mellemrum efter symboler
Nogle Markdown-processorer kræver et mellemrum efter # i overskrifter og efter - i lister. Inkludér altid mellemrummet for en sikkerheds skyld.
# Korrekt overskrift
#Forkert overskrift
- Korrekt listepunkt
-Forkert listepunkt
Advarsel Markdown understøtter ikke alle formateringsbehov. Hvis du har brug for komplekse layouts, farvet tekst, præcis typografi eller printklare dokumenter, kan du have brug for HTML, LaTeX eller et tekstbehandlingsprogram. Markdown egner sig bedst til struktureret, tekstfokuseret indhold.
Hvorfor Markdown er værd at lære
Markdown tager fem minutter at lære og sparer timer over tid. Når du kender det, kan du:
- Skrive dokumentation, der gengives smukt på GitHub
- Formatere beskeder i Slack og Discord uden at røre musen
- Tage strukturerede noter, der er portable på tværs af apps
- Oprette blogindlæg og webindhold fra rene tekstfiler
- Samarbejde om tekstbaserede dokumenter uden formatkompabilitets-problemer
Forholdet mellem indsats og udbytte er et af de bedste i hele tech-verdenen.
Begynd at skrive i Markdown nu:
Gratis, i din browser, med realtidsforhåndsvisning, mens du skriver.