Markdown-Grundlagen in 10 Minuten

Markdown ist eine einfache Auszeichnungssprache, mit der du Texte strukturieren kannst — ohne dabei mit komplizierten Editoren zu kämpfen. In diesem Kurs lernst du die wichtigsten Bausteine kennen.

Lernziele

Nach diesem Kurs kannst du:

• Texte mit Überschriften strukturieren
• Listen, Tabellen und Zitate formatieren
• Code-Blöcke und Inline-Code einsetzen
• Links und Bilder einbinden

Überschriften

Überschriften erstellst du mit #. Je mehr Rauten, desto kleiner die Ebene:

# Titel der Seite
## Hauptabschnitt
### Unterabschnitt

Faustregel: In jedem Kurs gibt es nur einen # Titel. Alles darunter beginnt ab ##.

Hervorhebungen

Innerhalb von Texten kannst du Wörter besonders hervorheben:

Listen

Aufzählungen mit -, nummerierte Listen mit 1.:

- Erstens
- Zweitens
  - Verschachtelt
- Drittens
 
1. Schritt eins
2. Schritt zwei
3. Schritt drei

Links und Bilder

Ein Link sieht so aus: [Beschriftung](https://example.com). Bilder sind fast identisch, nur mit einem Ausrufezeichen davor:

[Vercel Doku](https://vercel.com/docs)
![Alt-Text](/pfad/zum/bild.png)

Code

Inline-Code mit Backticks: `npm install`. Längere Code-Blöcke mit drei Backticks und optionaler Sprache zur Syntax-Hervorhebung:

```ts
const summe = (a: number, b: number) => a + b;
```

So sieht's gerendert aus:

const summe = (a: number, b: number) => a + b;
console.log(summe(2, 3));

Tabellen

Tabellen sind etwas fummeliger, aber überschaubar:

| Spalte A | Spalte B |
| --- | --- |
| 1 | eins |
| 2 | zwei |

Zitate und Hinweise

Zitate werden mit > eingeleitet:

Eine kluge Person hat einmal gesagt: Schreiben ist Denken auf Papier.

Praxis-Übung

Schreibe einen kurzen Text über ein Thema, das dich interessiert — und strukturiere ihn nur mit den gerade gelernten Markdown-Bausteinen:

• eine Hauptüberschrift und zwei Unterabschnitte
• eine Aufzählung mit drei Punkten
• ein Zitat oder ein hervorgehobener Hinweis
• ein kurzes Code-Beispiel oder eine Tabelle

Wenn der Text klar lesbar wirkt, ohne dass du auf das Layout achten musstest, ist Markdown bei dir angekommen.

Weiterführendes

• CommonMark Spezifikation
• GitHub Flavored Markdown

Mit diesen Grundlagen bist du bestens gerüstet, um eigene Kursinhalte zu verfassen. 🎯