Markdown-Spickzettel: GitHub-Flavored-Syntax mit Beispielen

Markdown ist die einfachste Art, formatierten Text zu schreiben, der auch als reiner Text lesbar bleibt. README-Dateien, Dokumentationen, Notizen, Chatnachrichten und statische Websites nutzen es. Dieser Spickzettel zeigt die Syntax, die Sie wirklich brauchen – mit Fokus auf GitHub-Flavored Markdown (GFM), den Dialekt, den GitHub, GitLab, die meisten Dokumentationswerkzeuge und der Markdown Preview Editor unterstützen.

Jedes Beispiel unten können Sie in den Online-Editor einfügen und das Ergebnis direkt daneben sehen.

Überschriften

Beginnen Sie eine Zeile mit einem bis sechs #-Zeichen, gefolgt von einem Leerzeichen. Ein # ist der Seitentitel, ## ein Abschnitt, ### ein Unterabschnitt.

markdown# Seitentitel
## Abschnitt
### Unterabschnitt
#### Kleinere Überschrift

Verwenden Sie pro Dokument nur eine #-Überschrift und überspringen Sie keine Ebenen (zum Beispiel von ## direkt zu ####). Screenreader und Suchmaschinen verstehen die Seite anhand der Überschriftenstruktur, und die meisten Vorschau-Tools erzeugen daraus ein Inhaltsverzeichnis.

Absätze und Zeilenumbrüche

Ein Absatz besteht aus einer oder mehreren Textzeilen und wird durch eine Leerzeile vom nächsten getrennt. Ein einfacher Zeilenumbruch innerhalb eines Absatzes wird ignoriert – die Zeilen werden zusammengefügt. Für einen erzwungenen Zeilenumbruch beenden Sie die Zeile mit zwei Leerzeichen oder einem Backslash:

markdownErste Zeile mit zwei Leerzeichen am Ende  
Zweite Zeile im selben Absatz.

Nach einer Leerzeile beginnt ein neuer Absatz.

Hervorhebung

Viele Editoren, darunter der Markdown Preview Editor, unterstützen außerdem einige beliebte Erweiterungen: ==highlight== zum Hervorheben, H~2~O für Tiefstellung, x^2^ für Hochstellung und Emoji-Kürzel im Stil von :smile:. Diese gehören nicht zu GFM selbst – prüfen Sie also Ihre Zielplattform, bevor Sie sich darauf verlassen.

Listen

Verwenden Sie -, * oder + für Aufzählungen und Zahlen für nummerierte Listen. Rücken Sie Einträge um zwei bis vier Leerzeichen ein, um sie zu verschachteln.

markdown- Milch
- Brot
  - Vollkorn
  - Roggen
- Kaffee

1. Repository klonen
2. Abhängigkeiten installieren
3. Build ausführen

Nummerierte Listen brauchen nicht die richtigen Zahlen – 1. in jeder Zeile wird trotzdem als 1, 2, 3 dargestellt. Beginnt die Liste mit einer anderen Zahl (zum Beispiel 5.), startet sie dort.

Aufgabenlisten

Aufgabenlisten sind eine GFM-Erweiterung, die Listeneinträge in Kontrollkästchen verwandelt. Sie eignen sich perfekt für READMEs, Release-Pläne und Besprechungsnotizen.

markdown- [x] Entwurf schreiben
- [x] Screenshots hinzufügen
- [ ] Beitrag veröffentlichen

Links

markdown[Linktext](https://example.com)
[Link mit Titel](https://example.com "Erscheint beim Überfahren mit der Maus")
<https://example.com>

Lesen Sie die [Installationsanleitung][install].

[install]: https://example.com/docs/install

Die letzte Form ist ein Referenzlink: Die URL wird einmal am Ende des Dokuments definiert, wodurch lange Absätze lesbar bleiben. Relative Links wie [Setup](docs/setup.md) verweisen auf andere Dateien im selben Projekt; im Markdown Preview Editor wechseln sie zu diesem Dokument, wenn es in einem anderen Tab geöffnet ist.

Bilder

Bilder verwenden die Link-Syntax mit einem vorangestellten Ausrufezeichen. Der Text in eckigen Klammern ist der Alternativtext – beschreiben Sie das Bild für Menschen, die es nicht sehen können.

markdown![Editor mit Live-Vorschau](images/screenshot.png)
![Logo](https://example.com/logo.svg "Optionaler Titel")

Wenn Sie ein Dokument mit lokalen Bildern in der Vorschau ansehen, öffnen Sie den ganzen Ordner oder ziehen Sie die Bilder zusammen mit der .md-Datei hinein, damit die Vorschau die relativen Pfade auflösen kann.

Code

Inline-Code steht zwischen einfachen Backticks. Für Blöcke umschließen Sie den Code mit drei Backticks und geben den Namen der Sprache für die Syntaxhervorhebung an:

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

Gängige Sprachnamen: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Enthält Ihr Code selbst drei Backticks, umschließen Sie ihn mit vier Backticks – wie im Beispiel oben.

Tabellen

Trennen Sie Spalten mit senkrechten Strichen (Pipes) und setzen Sie unter die Kopfzeile eine Zeile mit Bindestrichen. Doppelpunkte in der Trennzeile legen die Ausrichtung fest.

markdown| Funktion  | Gratis | Hinweise                  |
|:----------|:------:|--------------------------:|
| Vorschau  |   ✅   | Aktualisiert beim Tippen  |
| Export    |   ✅   | HTML, PDF, .md            |

:--- richtet links aus, :---: zentriert und ---: richtet rechts aus. Die Spalten müssen im Quelltext nicht bündig sein – ein guter Editor hält sie aber lesbar. Der Markdown Preview Editor hat in der Werkzeugleiste eine Tabellen-Schaltfläche, die eine fertige Vorlage einfügt.

Zitate und Hinweisblöcke

Stellen Sie Zeilen ein > voran, um Text zu zitieren. GitHub unterstützt außerdem Alerts (Hinweisblöcke) – Zitate mit einer speziellen ersten Zeile, die als farbige Kästen dargestellt werden:

markdown> Ein normales Zitat.

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

> [!TIP]
> Hilfreicher Rat, um etwas besser zu machen.

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

Die fünf Typen sind NOTE, TIP, IMPORTANT, WARNING und CAUTION. Setzen Sie sie sparsam ein: Ein Hinweis pro Abschnitt fällt auf, fünf hintereinander werden zum Rauschen.

Fußnoten

Fußnoten halten Randbemerkungen aus dem Haupttext heraus. Die Anmerkung kann an beliebiger Stelle definiert werden; dargestellt wird sie am Ende des Dokuments.

markdownMarkdown entstand 2004.[^1]

[^1]: Von John Gruber, mit Unterstützung von Aaron Swartz.

Horizontale Linien und Maskieren

Drei oder mehr Bindestriche, Sternchen oder Unterstriche in einer eigenen Zeile ergeben eine horizontale Linie: ---. Setzen Sie davor eine Leerzeile, sonst macht --- unter einer Textzeile diesen Text zu einer Überschrift.

Um ein Zeichen anzuzeigen, das Markdown sonst interpretieren würde, maskieren Sie es mit einem Backslash: \*nicht kursiv\*, \# keine Überschrift, \$5 (nützlich, wenn Formeln aktiviert sind).

Formeln und Diagramme

Zwei Erweiterungen sind in technischen Texten zum Standard geworden:

• Formeln – $E = mc^2$ für Formeln im Fließtext und $$ … $$ für abgesetzte Gleichungen. Mehr dazu in der vollständigen Anleitung Mathematische Formeln in Markdown.
• Diagramme – ein Codeblock mit der Sprache mermaid zeichnet Flussdiagramme, Sequenzdiagramme, Gantt-Diagramme und mehr. Siehe Mermaid-Diagramme in Markdown.

Front Matter

Statische Website-Generatoren lesen Metadaten aus einem YAML-Block ganz am Anfang der Datei:

yaml---
title: Mein Beitrag
date: 2026-09-27
tags: [markdown, docs]
---

Eine gute Vorschau blendet diesen Block aus, statt ihn als Text darzustellen. Der Markdown Preview Editor macht genau das.

Wie geht es weiter?

Die Syntax zu kennen ist die halbe Miete – die andere Hälfte ist, das Ergebnis schon beim Schreiben zu sehen. Lesen Sie, wie Sie eine Markdown-Vorschau online nutzen, ohne Dateien hochzuladen, und wenn Ihr Dokument fertig ist, erfahren Sie, wie Sie Markdown in HTML oder PDF umwandeln.