Der vollständige Markdown-Leitfaden - Von Grundlagen bis Fortgeschrittenes

Einführung: Was ist Markdown?

Markdown ist eine leichtgewichtige Markup-Sprache, die 2004 von John Gruber erstellt wurde. Ihr Hauptziel ist es, in ihrer Rohform so lesbar wie möglich zu sein und gleichzeitig in strukturell valides HTML konvertierbar zu sein. Heute ist Markdown zum De-facto-Standard für das Schreiben von Inhalten im Web geworden – von Dokumentationen und README-Dateien bis hin zu Blog-Beiträgen, Kommentaren und Messaging-Plattformen.

Möchtest du beim Lesen dieses Leitfadens üben? Probiere unser Markdown-Vorschau-Tool aus, um dein Markdown in Echtzeit gerendert zu sehen.

Warum Markdown verwenden?

• Lesbarkeit: Rohes Markdown ist auch ohne Rendering gut lesbar
• Portabilität: Markdown-Dateien sind Klartext und funktionieren überall
• Einfachheit: Die Syntax ist intuitiv und leicht zu lernen
• Breite Unterstützung: Verwendet von GitHub, GitLab, Reddit, Stack Overflow, Notion, Obsidian und vielen mehr
• Versionskontrolle-freundlich: Als Klartext arbeitet Markdown perfekt mit Git zusammen
• Konvertierbar: Markdown kann in HTML, PDF, DOCX und viele andere Formate konvertiert werden
• Fokus auf Inhalt: Markdown lässt dich dich auf das Schreiben konzentrieren, nicht auf die Formatierung

Grundlegende Syntax

Überschriften

Überschriften werden erstellt, indem man ein bis sechs #-Symbole vor den Überschriftentext setzt:

# Überschrift 1 (H1)
## Überschrift 2 (H2)
### Überschrift 3 (H3)
#### Überschrift 4 (H4)
##### Überschrift 5 (H5)
###### Überschrift 6 (H6)

Best Practices für Überschriften:

• Immer ein Leerzeichen zwischen # und dem Überschriftentext
• Nur ein H1 pro Dokument (normalerweise der Titel)
• Keine Überschriftebenen überspringen (von H2 zu H3, nicht H2 zu H4)
• Überschriften kurz und beschreibend halten

Betonung (Fett und Kursiv)

*kursiver Text* oder _kursiver Text_

**fetter Text** oder __fetter Text__

***fett und kursiv*** oder ___fett und kursiv___

~~durchgestrichener Text~~

Blockzitate

> Das ist ein Blockzitat.
>
> Es kann mehrere Absätze umfassen.

> Blockzitate können verschachtelt werden.
>
>> Das ist ein verschachteltes Blockzitat.

Listen

Ungeordnete Listen mit -, * oder +:

- Punkt 1
- Punkt 2
  - Unterpunkt 2.1
  - Unterpunkt 2.2
- Punkt 3

Geordnete Listen mit Zahlen gefolgt von Punkten:

1. Erster Punkt
2. Zweiter Punkt
3. Dritter Punkt

Links und Bilder

Links

[Linktext](https://example.com)

[Link mit Titel](https://example.com "Link-Titel")

<https://example.com> (automatischer Link)

Bilder

![Alt-Text](bild-url.png)

![Alt-Text](bild-url.png "Bildtitel")

Code

Inline-Code

Inline-Code mit einzelnen Backticks umschließen:

Verwende die `console.log()`-Funktion zum Debuggen.

Codeblöcke

Triple-Backticks mit optionalem Sprachbezeichner für Syntaxhervorhebung:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

```python
def greet(name):
    return f"Hello, {name}!"
```

Tabellen

Tabellen werden mit Pipes (|) und Bindestrichen (-) erstellt:

| Feature | Free-Plan | Pro-Plan | Enterprise |
|---------|-----------|----------|------------|
| Nutzer | 1 | 10 | Unbegrenzt |
| Speicher | 1 GB | 100 GB | 1 TB |
| Support | Community | E-Mail | 24/7 Telefon |

Gerendertes Ergebnis:

Feature	Free-Plan	Pro-Plan	Enterprise
Nutzer	1	10	Unbegrenzt
Speicher	1 GB	100 GB	1 TB
Support	Community	E-Mail	24/7 Telefon

GitHub Flavored Markdown (GFM)

Aufgabenlisten

- [x] Projekt-Setup abgeschlossen
- [x] Dokumentation geschrieben
- [ ] Unit-Tests hinzufügen
- [ ] In Produktion deployen

Gerendertes Ergebnis:

• Projekt-Setup abgeschlossen
• Dokumentation geschrieben
• Unit-Tests hinzufügen
• In Produktion deployen

Emoji

GFM unterstützt Emoji-Shortcodes:

:smile: :rocket: :bug: :white_check_mark: :warning:

Fußnoten

Diese Aussage braucht eine Quelle[^1].

[^1]: Quelle: Journal of Computer Science, 2026.

GitHub-Alerts

> [!NOTE]
> Nützliche Informationen, die Nutzer wissen sollten.

> [!WARNING]
> Dringende Informationen, die sofortige Aufmerksamkeit erfordern.

Markdown-Best Practices

Dokumentstruktur

1. Mit einem einzelnen H1 beginnen: Dies ist normalerweise der Dokumenttitel
2. Überschriften hierarchisch verwenden: H2 für Hauptabschnitte, H3 für Unterabschnitte
3. Absätze kurz halten: 3-5 Sätze pro Absatz anstreben
4. Immer die Sprache angeben: Fenced Code Blocks mit Sprachbezeichnern verwenden

Häufige Verwendungsfälle

README-Dateien

# Projektname

Kurze Beschreibung des Projekts.

## Installation

\`\`\`bash
npm install project-name
\`\`\`

## Verwendung

\`\`\`javascript
import { tool } from 'project-name';
tool.execute();
\`\`\`

Markdown-Kurzreferenz

Element	Syntax	Hinweise
Überschrift	# H1 bis ###### H6	Leerzeichen nach #
Fett	**Text**	Oder __Text__
Kursiv	*Text*	Oder _Text_
Durchgestrichen	~~Text~~	GFM-Feature
Blockzitat	> Text	Verschachtelbar
Geordnete Liste	1. Punkt	Zahlen automatisch
Ungeordnete Liste	- Punkt	Auch * oder +
Inline-Code	`Code`	Einzelne Backticks
Codeblock	```	Triple-Backticks
Link	[Text](url)	Titel optional
Bild		Titel optional
Horizontale Linie	---	Auch *** oder ___
Tabelle	| Spalte | Spalte |	GFM-Feature
Aufgabenliste	- [x] erledigt	GFM-Feature
Fußnote	Text[^1]	Nicht universell

Fazit

Markdown ist ein mächtiges und dennoch einfaches Werkzeug, das jeder Entwickler und technische Autor kennen sollte. Sein Klartext-Format macht es perfekt für versionskontrollierte Dokumentation, Blog-Beiträge, README-Dateien und vieles mehr.

Um Markdown zu üben und deine Arbeit sofort gerendert zu sehen, probiere unser kostenloses Markdown-Vorschau-Tool aus.

Verwandte Ressourcen

• Markdown-Vorschau — Markdown in Echtzeit vorschauen
• Wortzähler — Wörter in Markdown-Dokumenten zählen
• JSON-Formatter — JSON für Code-Beispiele formatieren
• Regex-Leitfaden für Einsteiger — Regex für die Textverarbeitung lernen