Markdown-Syntax-Übersicht: Alle Elemente mit Beispielen erklärt

Diese Übersicht führt alle Bausteine der Markdown-Syntax mit kurzen Beispielen vor. Sie ist als Nachschlagewerk gedacht: Sie können von oben nach unten lesen oder gezielt zu dem Element springen, das Sie gerade brauchen. Jedes Beispiel ist so kurz gehalten, dass Sie es direkt nachbauen können. Wer eine noch kompaktere Befehlsliste sucht, findet sie im Markdown-Spickzettel. Eine grundlegende Einführung bietet der Ratgeber Was ist Markdown.

Block-Elemente

Block-Elemente sind die großen Bausteine eines Textes. Jedes steht für sich und bildet einen eigenen Abschnitt. Sie werden in der Regel durch Leerzeilen voneinander getrennt.

Überschriften

Überschriften beginnen mit einer bis sechs Rauten, gefolgt von einem Leerzeichen. Je mehr Rauten, desto tiefer die Ebene:

# Überschrift Ebene 1
## Überschrift Ebene 2
### Überschrift Ebene 3

Absätze

Ein Absatz ist einfach ein Block aus Text. Zwei Absätze trennen Sie durch eine Leerzeile. Ein bloßer Zeilenumbruch ohne Leerzeile wird oft nicht als neuer Absatz gewertet:

Ein erster Absatz. Eine Leerzeile trennt ihn vom nächsten.

Der zweite Absatz beginnt nach der Leerzeile.

Listen

Ungeordnete Listen beginnen mit einem Bindestrich, einem Sternchen oder einem Pluszeichen. Geordnete Listen beginnen mit einer Zahl und einem Punkt. Untergeordnete Punkte entstehen durch Einrückung:

- Erster Punkt
- Zweiter Punkt
  - Untergeordneter Punkt

1. Erster Schritt
2. Zweiter Schritt

Zitate

Zitate beginnen mit einem Größer-als-Zeichen am Zeilenanfang. Über eine Zeile mit nur dem Zeichen lassen sich mehrere Absätze im selben Zitat bilden:

> Ein Zitat über eine Zeile.
>
> Mit zweitem Absatz im selben Zitat.

Code-Blöcke

Längeren Code umschließen Sie mit drei Backticks. Hinter die einleitenden Backticks dürfen Sie den Namen der Programmiersprache schreiben, was bei vielen Systemen ein farbiges Highlighting auslöst:

```python
print("Hallo Welt")
```

Inline-Elemente

Inline-Elemente formatieren einzelne Stellen innerhalb eines Textes, ohne einen neuen Abschnitt zu beginnen. Sie stehen mitten im Satz. Fetter Text entsteht durch doppelte Sternchen, kursiver durch einfache, Inline-Code durch einzelne Backticks. Links bestehen aus dem Linktext in eckigen Klammern und der Adresse in runden, Bilder funktionieren genauso, nur mit einem Ausrufezeichen davor:

Schreiben Sie **fett**, *kursiv* oder `Inline-Code`.

Ein [Link](https://html-md.de) und ein ![Bild](bild.png).

Der Unterschied zwischen Link und Bild liegt allein im Ausrufezeichen. Ein Link führt zu einer Adresse, ein Bild bindet eine Grafik ein, deren Quelle in den runden Klammern steht. Der Text in den eckigen Klammern dient beim Bild als Alternativtext, der angezeigt wird, falls die Grafik nicht geladen werden kann.

GFM-Erweiterungen

GitHub Flavored Markdown ergänzt den Kern um einige praktische Elemente. Dazu gehören durchgestrichener Text mit doppelten Tilden und Task-Listen mit abhakbaren Kästchen:

~~durchgestrichen~~

- [x] erledigt
- [ ] offen

Ebenfalls zu GFM gehören Tabellen mit Pipe-Zeichen und das automatische Erkennen von Webadressen. Tabellen behandelt der Ratgeber Markdown-Tabelle erstellen ausführlich, alle GFM-Funktionen erklärt der Ratgeber GitHub Flavored Markdown. Beachten Sie, dass GFM-Elemente nicht in jedem System verfügbar sind.

Verschachtelung und Einrückung

Markdown erlaubt es, Elemente ineinander zu verschachteln, etwa eine Liste innerhalb eines Listenpunkts oder einen Absatz innerhalb eines Zitats. Der Schlüssel dazu ist die Einrückung. Untergeordnete Inhalte rücken Sie so weit ein, dass sie auf einer Höhe mit dem Text des übergeordneten Punkts beginnen, meist um zwei bis vier Leerzeichen:

1. Erster Schritt
   - Ein Detail dazu
   - Noch ein Detail
2. Zweiter Schritt

Entscheidend ist Einheitlichkeit. Wenn Sie einmal mit drei Leerzeichen einrücken, sollten Sie das durchhalten. Mischen Sie Einrückungstiefen oder Tabulatoren mit Leerzeichen, erkennt der Verarbeiter die Schachtelung womöglich nicht und stellt alles auf einer Ebene dar. Im Zweifel ist es besser, einheitlich vier Leerzeichen zu verwenden, weil das von praktisch allen Systemen verstanden wird.

Häufige Stolperfallen

Die meisten Markdown-Probleme gehen auf eine Handvoll wiederkehrender Fehler zurück. Wer sie kennt, vermeidet sie leicht:

• Fehlende Leerzeile: Vor einer Liste, einer Überschrift oder einem Code-Block braucht es oft eine Leerzeile. Fehlt sie, hängt das Element am vorherigen Absatz und wird nicht erkannt.
• Vergessenes Leerzeichen: Nach der Raute einer Überschrift und nach dem Listenzeichen muss ein Leerzeichen stehen. Ohne dieses Leerzeichen bleibt der Text unverändert.
• Uneinheitliche Einrückung: Bei verschachtelten Listen führt eine ungleiche Anzahl von Leerzeichen dazu, dass die Ebenen durcheinandergeraten.
• Nicht maskierte Sonderzeichen: Zeichen wie Stern, Unterstrich, Raute oder eckige Klammer haben in Markdown eine Bedeutung. Wollen Sie sie wörtlich zeigen, setzen Sie einen Backslash davor.
• Falsche Dialekt-Erwartung: Eine GFM-Tabelle oder Task-Liste erscheint als roher Text, wenn das Zielsystem GFM nicht unterstützt.

Diese Fehler sind harmlos und schnell behoben, sobald man sie kennt. In den allermeisten Fällen genügt es, eine Leerzeile einzufügen oder ein fehlendes Leerzeichen zu ergänzen, und das Element wird korrekt dargestellt.

Live ausprobieren im Tool

Der schnellste Weg, eine Syntaxregel zu verstehen, ist, sie auszuprobieren. Auf html-md.de fügen Sie Ihr Markdown ein und sehen sofort das gerenderte Ergebnis als HTML und in der Vorschau. So prüfen Sie in Sekunden, ob eine Überschrift, eine Liste oder eine Tabelle wie gewünscht erscheint, ganz ohne Installation und ohne dass Ihre Inhalte das Gerät verlassen.

Besonders nützlich ist das beim Lernen: Schreiben Sie ein Element, sehen Sie das Ergebnis, ändern Sie etwas und beobachten Sie, was passiert. Wer den umgekehrten Weg gehen und bestehendes HTML in Markdown verwandeln möchte, findet die Anleitung im Ratgeber HTML in Markdown umwandeln. Für den Weg von Markdown zu HTML hilft der Ratgeber Markdown in HTML umwandeln. Mit dieser Übersicht und dem Konverter an der Seite haben Sie alles beisammen, um Markdown sicher zu beherrschen.

Häufige Fragen