Markdown Syntax: der komplette Spickzettel
Alle wichtigen Markdown-Befehle mit Beispielen zum Kopieren
Sprache: Deutsch · English version
Kurz gesagt: Markdown formatiert Text mit einfachen Zeichen: # für Überschriften, **fett**, *kursiv*, ~~durchgestrichen~~, [Link](URL), , - für Aufzählungen und - [ ] für Checkboxen. Unterstreichen und Textfarbe gibt es in Markdown nicht.
Diese Übersicht folgt CommonMark und den Erweiterungen von GitHub Flavored Markdown (GFM), die fast alle Programme verstehen. Wo sich Programme unterscheiden, steht es dabei. Was eine MD-Datei überhaupt ist, erklärt Was ist eine MD-Datei?.
Spickzettel auf einen Blick
| Element | Markdown |
|---|---|
| Überschrift | # Titel |
| Fett | **fett** |
| Kursiv | *kursiv* |
| Durchgestrichen | ~~alt~~ |
| Link | [Text](https://…) |
| Bild |  |
| Aufzählung | - Punkt |
| Nummerierte Liste | 1. Punkt |
| Checkbox | - [ ] Aufgabe |
| Code | `code` |
| Zitat | > Zitat |
| Trennlinie | --- |
Überschriften
Eine bis sechs Rauten am Zeilenanfang, gefolgt von einem Leerzeichen. # ist die größte Überschrift (H1), ###### die kleinste (H6).
# Überschrift 1
## Überschrift 2
### Überschrift 3
Wichtig: Ohne Leerzeichen nach der Raute (#Titel) erkennen viele Programme keine Überschrift. Pro Dokument sollte es nur eine H1 geben.
Absatz und Zeilenumbruch
Ein neuer Absatz entsteht durch eine Leerzeile. Ein einfacher Zeilenumbruch im Quelltext wird dagegen meist ignoriert – die Zeilen laufen zusammen. Für einen Zeilenumbruch innerhalb eines Absatzes gibt es drei Wege:
Zeile eins mit zwei Leerzeichen am Ende
Zeile zwei
Zeile eins mit Backslash\
Zeile zwei
Zeile eins<br>Zeile zwei
Zwei Leerzeichen am Zeilenende sind unsichtbar und gehen leicht verloren; der Backslash oder <br> ist eindeutiger. Auf GitHub erzeugen in Kommentaren und Issues schon einfache Zeilenumbrüche eine neue Zeile, in README-Dateien nicht.
Fett
Text zwischen zwei Sternchen oder zwei Unterstrichen wird fett:
**fetter Text**
__auch fett__
Mitten im Wort funktionieren nur Sternchen zuverlässig: Markdown**editor**.
Kursiv
Ein Sternchen oder ein Unterstrich auf jeder Seite macht Text kursiv; drei Sternchen ergeben fett und kursiv:
*kursiver Text*
_auch kursiv_
***fett und kursiv***
Durchgestrichen
Zwei Tilden auf jeder Seite streichen Text durch. Das ist eine GFM-Erweiterung, die GitHub, VS Code, Obsidian und die meisten Viewer unterstützen:
~~durchgestrichener Text~~
Unterstreichen
Markdown hat kein eigenes Zeichen zum Unterstreichen – Unterstriche bedeuten kursiv. Wo HTML erlaubt ist, hilft das <ins>- oder <u>-Tag:
<ins>unterstrichen</ins>
<u>unterstrichen</u>
Auf GitHub funktioniert <ins> zuverlässig. Unterstreichungen sehen im Web allerdings schnell wie Links aus – fett ist meist die bessere Hervorhebung.
Hervorheben und Textfarbe
Für markierten Text gibt es kein Standard-Markdown. Einige Programme (z. B. Obsidian) verstehen ==markiert==, sonst hilft HTML:
==markiert== (nur in manchen Programmen)
<mark>markiert</mark> (wo HTML erlaubt ist)
Eine Textfarbe kennt Markdown ebenfalls nicht. HTML wie <span style="color:red"> wird von GitHub entfernt und funktioniert nur in Programmen, die Inline-Styles zulassen.
Links
[Linktext](https://getmd.ma)
[Linktext](https://getmd.ma "Titel beim Überfahren")
<https://getmd.ma>
[Zum Abschnitt](#ueberschriften)
In GitHub Flavored Markdown werden auch nackte Adressen wie https://getmd.ma automatisch zu Links. Ein Link auf eine Überschrift im selben Dokument verwendet deren Anker – auf GitHub die Überschrift in Kleinbuchstaben, Leerzeichen durch Bindestriche ersetzt.
Bilder einfügen
Ein Bild ist ein Link mit vorangestelltem Ausrufezeichen. Der Text in eckigen Klammern ist der Alternativtext:


[](https://getmd.ma) ← Bild als Link
Relative Pfade wie bilder/screenshot.png beziehen sich auf den Ordner der MD-Datei. Eine Größe lässt sich in reinem Markdown nicht festlegen; dafür nutzen Sie HTML: <img src="logo.png" width="200">.
Aufzählungen und Listen
Eine Aufzählung beginnt mit -, * oder +, eine nummerierte Liste mit Zahl und Punkt. Eingerückte Zeilen (zwei bis vier Leerzeichen) werden zu Unterpunkten:
- Erster Punkt
- Zweiter Punkt
- Unterpunkt
1. Erster Schritt
2. Zweiter Schritt
3. Dritter Schritt
Bei nummerierten Listen zählt nur die erste Zahl: Auch 1. in jeder Zeile ergibt 1, 2, 3.
Checkbox (Aufgabenliste)
Aufgabenlisten sind eine GFM-Erweiterung: ein Listenpunkt mit [ ] für offen oder [x] für erledigt.
- [x] Entwurf schreiben
- [ ] Korrektur lesen
- [ ] Veröffentlichen
Auf GitHub lassen sich die Kästchen in Issues und Pull Requests direkt anklicken; in einer README sind sie nur Anzeige.
Code und Codeblock
Kurzer Code im Text steht zwischen Backticks: `npm install`. Für einen Codeblock setzen Sie drei Backticks in eine eigene Zeile davor und danach; die Sprache dahinter aktiviert die Syntaxhervorhebung:
```python
def hallo(name):
print(f"Hallo {name}")
```
Enthält der Code selbst Backticks, nehmen Sie außen vier Backticks oder drei Tilden (~~~).
Zitate
> Das ist ein Zitat.
>
> > Ein verschachteltes Zitat.
GitHub kennt außerdem farbige Hinweisboxen: > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING] und > [!CAUTION] in der ersten Zeile eines Zitats.
Tabellen
| Name | Preis |
|:-------|------:|
| Lite | 0 $ |
| Pro | 9,99 $|
Doppelpunkte in der Trennzeile richten die Spalten aus: links :---, zentriert :---:, rechts ---:. Zellen verbinden, Zeilenumbrüche in Zellen und einen Generator gibt es in Markdown Tabelle erstellen.
Trennlinie, Kommentar und Escape
---
<!-- Dieser Kommentar ist in der Vorschau unsichtbar -->
\*keine Kursivschrift\*
- Trennlinie: drei Bindestriche, Sternchen oder Unterstriche in einer eigenen Zeile. Direkt unter einer Textzeile machen
---diese allerdings zur Überschrift – lassen Sie eine Leerzeile davor. - Kommentar: HTML-Kommentare werden nicht angezeigt, bleiben aber in der Datei lesbar.
- Escape: Ein Backslash vor einem Sonderzeichen (
\*,\#,\_) zeigt es als normales Zeichen an.
Fußnoten
Markdown wurde 2004 veröffentlicht.[^1]
[^1]: Von John Gruber, gemeinsam mit Aaron Swartz.
Fußnoten unterstützen GitHub und viele Editoren; nicht jedes Programm zeigt sie an.
Markdown ausprobieren
Schreiben Sie die Beispiele in eine Datei mit der Endung .md und öffnen Sie sie in einem Markdown Viewer – auf dem Mac zum Beispiel mit MDViewer oder ohne Installation im Online-Viewer.
Häufige Fragen
Wie schreibe ich in Markdown fett?
Setzen Sie den Text zwischen zwei Sternchen: **fett**. Zwei Unterstriche (__fett__) funktionieren ebenfalls, aber nicht mitten im Wort.
Wie schreibe ich in Markdown kursiv?
Mit einem Sternchen oder Unterstrich auf jeder Seite: *kursiv* oder _kursiv_. Drei Sternchen (***text***) ergeben fett und kursiv.
Wie mache ich in Markdown einen Zeilenumbruch?
Eine Leerzeile beginnt einen neuen Absatz. Für einen Umbruch innerhalb des Absatzes setzen Sie zwei Leerzeichen oder einen Backslash ans Zeilenende oder schreiben <br>.
Kann man in Markdown unterstreichen?
Nicht mit Markdown-Zeichen. Wo HTML erlaubt ist, nutzen Sie <ins>text</ins> oder <u>text</u>; auf GitHub funktioniert <ins>.
Wie füge ich in Markdown ein Bild ein?
Mit . Der Pfad kann relativ zur MD-Datei oder eine vollständige URL sein. Für eine feste Größe nutzen Sie HTML: <img src="bild.png" width="300">.
Wie erstelle ich eine Checkbox in Markdown?
Mit einem Listenpunkt und eckigen Klammern: - [ ] offen und - [x] erledigt. Das ist eine Erweiterung von GitHub Flavored Markdown.
Wie färbe ich Text in Markdown ein?
Gar nicht – Markdown kennt keine Textfarben. HTML mit style-Attribut funktioniert nur in Programmen, die Inline-Styles erlauben; GitHub entfernt es.
MDViewer für den Mac
MDViewer ist ein nativer Markdown-Viewer für macOS: Doppelklick auf eine .md-Datei, und sie erscheint formatiert – mit Inhaltsverzeichnis, Tabellen, Code-Blöcken und Mermaid-Diagrammen. Ohne Installation geht es auch im Browser mit dem Online-Markdown-Viewer.
Lite kostenlos für private Nutzung · Pro 9,99 $ einmalig · macOS 13 oder neuer, Intel und Apple Silicon · Die App-Oberfläche ist auf Englisch.