Kodeagenter
Erhvervsakademi Zealand

Markdown Tutorial for undervisere

HTML-udgave af guiden fra kursus/markdown-tutorial.md.

Hvorfor bruge Markdown?

Markdown er en enkel måde at skrive strukturerede dokumenter uden avancerede tekstbehandlere. Her er tre gode grunde:

  1. Let at læse og skrive – teksten forbliver ren og overskuelig.
  2. Perfekt til kodeagenter og AI-værktøjer – Markdown gør det nemt for AI at forstå struktur, afsnit, overskrifter og kodeblokke.
  3. Ensartethed på tværs af filer – Alle dokumenter kan versionstyres i GitHub og åbnes i enhver editor.

Kom godt i gang med Markdown

Nedenfor finder du de mest grundlæggende og nyttige formateringer i Markdown. De er nok til at komme i gang med at skrive tydelige faglige dokumenter.

1. Overskrifter

Overskrifter laves med # i starten af en linje.

# Dette er en H1-overskrift (titel)
## Dette er en H2-overskrift
### Dette er en H3-overskrift

2. Fed og kursiv tekst

**Fed**
*Kursiv*
***Fed og kursiv***

3. Punktlister

Uordnet liste:

- Punkt 1
- Punkt 2
  - Underpunkt

Ordnet liste:

1. Første punkt
2. Andet punkt

4. Links

[Tekst der vises](https://example.com)

5. Billeder

![Alternativ tekst](link-til-billede.png)

6. Kodeblokke

Til generel kode:

```javascript
console.log("Hej verden");
```

Til inline-kode:

`console.log()`

7. Citater

> Dette er et citat.
> Bruges ofte til at fremhæve noget.

8. Tabeller

| Kolonne 1 | Kolonne 2 |
|----------|-----------|
| Tekst    | Tekst     |
| Mere     | Mere      |

9. Vandrette linjer

---

10. Tips til god Markdown-praksis

  • Hold linjerne korte (max 80–100 tegn).
  • Brug overskrifter til at strukturere dokumentet logisk.
  • Brug punktlister i stedet for lange afsnit.
  • Brug kodeblokke når du skriver kode eller tekniske eksempler.

11. Markdown og kodeagenter

Når du arbejder med kodeagenter eller AI, er Markdown særligt fordelagtigt:

  • AI læser struktur bedre → færre misforståelser.
  • Kodeblokke gør det nemt for modellen at forstå, hvad der er kode.
  • Let at generere konsistente pdf-rapporter, prompts og dokumentation.
  • Markdown er perfekt til GitHub og versionsstyring.

Klar til brug

Du kan nu skrive tekniske dokumenter, opgavebeskrivelser, rubrics eller guides i Markdown med lethed. Markdown er simpelt – og jo mere du bruger det, jo hurtigere bliver du.

God fornøjelse!