Markdown er et enkelt sprog designet til at strømline indholdsskrivning. Det bruges overalt, fra GitHub til note-apps. Uanset om du er forfatter, udvikler, eller bare nogen, der ønsker at forenkle din web-skrivning, er denne guide til dig!
Markdown er et letvægts markup-sprog, skabt af John Gruber i 2004, for at gøre formateret tekst letlæselig i plain-text redigeringsprogrammer. Det er især populært til blogging, instant messaging, fora, samarbejdsværktøjer, dokumentation og readme-filer. Over tid førte variationer i dens fortolkning til oprettelsen af CommonMark i 2014, en klarere specifikation med en testpakke for at sikre ensartet implementering.
Her er en hurtig gennemgang af de mest almindelige elementer, du vil have brug for:
Overskrifter oprettes ved at bruge #
-symbolet efterfulgt af et mellemrum:
# Dette er en H1
## Dette er en H2
### Dette er en H3
For kursiv brug *asterisker*
eller _understregninger_
.
For fed brug **dobbelt asterisker**
eller __dobbelt understregninger__
.
Brug asterisker, plus eller minus efterfulgt af et mellemrum:
* Emne 1
* Emne 2
* Underemne 2.1
* Underemne 2.2
Brug simpelthen tal efterfulgt af punktummer:
1. Første emne
2. Andet emne
3. Tredje emne
Du kan oprette et inline link med følgende syntaks:
[Vist tekst](URL "Valgfri titel")
Billeder er lig med links, men med et forudgående udråbstegn:
![Alternativ tekst](URL "Valgfri titel")
For blokcitater skal du bruge >
-tegnet før din tekst:
> Dette er et blokcitat.
For inline kode
, ombryd din kode med accenter:
`kode her`
For flerlinjede kodestykker, brug triple accenter:
\```
Linje 1 af kode
Linje 2 af kode
Linje 3 af kode
\```
Du kan oprette en horisontal linje med tre bindestreger, asterisker eller understregninger:
---
| Overskrift1 | Overskrift2 |
|------------|------------|
| celle1 | celle2 |
| celle3 | celle4 |
Overskrift1 | Overskrift2 |
---|---|
celle1 | celle2 |
celle3 | celle4 |
- [x] Fuldført opgave
- [ ] Ikke fuldført opgave
[Link tekst](#ankernavn)
# Denne overskrift er et anker
[Link til anker ovenfor](#denne-overskrift-er-et-anker)
Markdown har ikke en indbygget syntaks til citater, men mange værktøjer, som Pandoc, understøtter udvidelser for det.
Ifølge Smith [-@Smith2023], er Markdown forbløffende enkelt.
Det er også blevet observeret af Doe [@Doe2022] i hans seneste publikation.
[@Smith2023, s. 23-25]
[@Doe2022, kap. 2]
Bemærk: Bemærk brugen af -
før @Smith2023
. På denne måde gentages forfatterens navn ikke, når du vil have citationen i parentes. Uden -
ville det betragtes som en narrativ citation.
For at oprette og administrere din bibliografi anbefaler vi at bruge CiteDrive. CiteDrive er en cloud-baseret, samarbejdende referencemanager, der er indfødt til BibTeX, designet specielt til Overleaf, LaTeX, og R Markdown brugere. Den forenkler processen med at oprette og eksportere citater i .bib
format.
Her er et eksempel på en BibTeX-post, du kan have i din .bib
fil:
@article{Smith2023,
title = {Studietitel},
author = {Smith, John},
year = 2023,
journal = {Journalnavn},
volume = 5,
pages = {10--20}
}
Pandoc kan konvertere din markdown-fil med citater til et korrekt formateret dokument ved hjælp af CSL-stil. Her er den grundlæggende kommando:
pandoc dinfil.md --citeproc --bibliography=dinBibFil.bib --csl=dinCSLstil.csl -o output.docx
Hvor:
dinfil.md
er din markdown-fil.--citeproc
aktiverer citatprocessoren.dinBibFil.bib
er din bibliograffil.dinCSLstil.csl
er din valgte citationstil (som APA, MLA osv.). Der er mange CSL-stile tilgængelige online.output.docx
er den ønskede output-fil (i dette tilfælde et Word-dokument).Husk, at du for at dette skal fungere, vil have brug for både Pandoc og de relevante CSL-filer. Det endelige output vil afhænge af den CSL-stil, du vælger.