Grundlegende Markdown Syntax: der Guide
Die grundlegende Markdown Syntax umfasst die 11 Formatierungselemente, die John Gruber im ursprünglichen Design-Dokument von 2004 definiert hat, und fast jede Markdown-Anwendung unterstützt 2026 noch den kompletten Satz. Die 11 Elemente sind Überschriften, Absätze, Zeilenumbrüche, Hervorhebungen, Blockzitate, Listen, Code, horizontale Linien, Links, Bilder und das Maskieren von Zeichen. Jedes Element nutzt Satzzeichen, die bereits auf Ihrer Tastatur liegen, und jedes wird in einen bestimmten HTML-Tag umgewandelt. Zwischen den Prozessoren gibt es kleine Unterschiede, deshalb markiert diese Anleitung die Varianten, die überall identisch gerendert werden. Jedes Beispiel unten lässt sich direkt in einen Markdown-Editor mit Live-Vorschau einfügen, und die gerenderte Ausgabe erscheint, während Sie tippen.
Überschriften
Eine Markdown Überschrift beginnt mit 1 bis 6 Rautezeichen (#) gefolgt von einem Leerzeichen, und die Anzahl der Zeichen bestimmt die Ebene von H1 bis H6.
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
Jede Zeile wird in den passenden HTML-Tag umgewandelt: # Page Title wird als h1-Element gerendert und ###### Fine Print als h6. Markdown kennt außerdem eine alternative Syntax für die obersten 2 Ebenen. Setzen Sie eine beliebige Anzahl Gleichheitszeichen in die Zeile unter den Text für eine H1 oder eine beliebige Anzahl Bindestriche für eine H2. Die #-Form heißt ATX-Stil; die unterstrichene Form heißt Setext-Stil.
Heading level 1
===============
Heading level 2
---------------
Best Practice: Lassen Sie vor und nach jeder Überschrift eine Leerzeile und halten Sie 1 Leerzeichen zwischen den Rautezeichen und dem Text, damit die Überschrift in jeder Anwendung korrekt gerendert wird.
Absätze
Ein Absatz besteht aus einer oder mehreren aufeinanderfolgenden Textzeilen mit je einer Leerzeile darüber und darunter, und er braucht überhaupt keine Marker.
The first paragraph ends here.
A blank line above this sentence starts a second paragraph.
Der Renderer packt jeden Block in einen p-Tag, die 2 Blöcke oben werden also zu 2 getrennten HTML-Absätzen. Einzelne Zeilenwechsel innerhalb eines Blocks verschmelzen zu fortlaufendem Text, Sie können Ihre Quellzeilen also bei 80 Zeichen umbrechen, und die Ausgabe bleibt ein durchgehender Absatz.
Best Practice: Halten Sie jeden Absatz bündig am linken Rand, denn 4 oder mehr führende Leerzeichen machen aus einem Absatz einen Codeblock.
Zeilenumbrüche
Ein Zeilenumbruch innerhalb eines Absatzes verlangt 2 oder mehr Leerzeichen am Zeilenende oder den HTML-Tag <br>.
This line ends with 2 trailing spaces.
This line appears directly below it.
This line ends with a br tag.<br>
This line also sits inside the same paragraph.
Beide Methoden rendern ein br-Element, die zweite Zeile landet also direkt unter der ersten, ohne Absatzabstand. Ein einfacher Zeilenwechsel ohne Zusatz verschmilzt die 2 Zeilen zu einer. CommonMark akzeptiert auch einen abschließenden Backslash als Umbruch, ältere Prozessoren ignorieren ihn jedoch, die 2 portablen Optionen bleiben also nachgestellte Leerzeichen und der <br>-Tag.
Best Practice: Wählen Sie den <br>-Tag, wenn ein Umbruch Copy-and-paste und Code-Review überstehen muss, denn nachgestellte Leerzeichen bleiben in den meisten Editoren unsichtbar.
Hervorhebungen: fett und kursiv
Wer in Markdown fett schreiben will, setzt 2 Sternchen auf jede Seite, für kursiv 1 und für fett kursiv 3; Unterstriche dienen rund um ganze Wörter als gleichwertige Alternative.
This word is **bold** and so is this __word__.
This word is *italic* and so is this _word_.
This phrase is ***bold and italic***.
Der Renderer wandelt die Marker in strong- und em-Tags um: **bold** wird zu <strong>bold</strong>, *italic* wird zu <em>italic</em>, und der dreifache Marker verschachtelt einen Tag im anderen. Hervorhebung funktioniert auch mitten im Wort, un*believ*able setzt also nur die 6 mittleren Buchstaben kursiv.
Best Practice: Nutzen Sie für Hervorhebungen mitten im Wort Sternchen statt Unterstriche, denn jeder große Prozessor behandelt innenliegende Sternchen gleich, während innenliegende Unterstriche variieren.
Blockzitate
Ein Blockzitat beginnt mit einem Größer-als-Zeichen (>) am Zeilenanfang, und jede zitierte Zeile trägt ihren eigenen Marker.
> A single-paragraph quote needs 1 marker per line.
>
> A marked blank line continues the quote into a second paragraph.
>
>> Two markers push this paragraph 1 level deeper as a nested quote.
Die Ausgabe ist ein blockquote-Element, und der doppelte Marker verschachtelt ein zweites Blockzitat im ersten. Zitate nehmen auch anderes Markdown auf. Eine Überschrift, eine Liste oder fetter Text wird innerhalb des Zitats normal gerendert, wenn jede seiner Zeilen mit dem >-Marker beginnt, was zu zitierten E-Mails und strukturierten Zitatpassagen passt.
Best Practice: Umgeben Sie jedes Blockzitat mit Leerzeilen, damit jeder Prozessor exakt erkennt, wo das Zitat beginnt und endet.
Listen
Eine geordnete Markdown Liste stellt jedem Punkt eine Zahl mit Punkt voran, eine ungeordnete Liste einen Bindestrich, ein Sternchen oder ein Pluszeichen.
1. First step
2. Second step
3. Third step
1. Indented sub-step
- Bullet item
- Bullet item
- Nested bullet
Geordnete Listen werden als ol-Elemente gerendert und zählen ab der ersten getippten Zahl, eine als 1, 8, 3 geschriebene Liste gibt also trotzdem 1, 2, 3 aus. Ungeordnete Listen werden als ul-Elemente mit jedem der 3 Trennzeichen gerendert. Ein Einzug von 4 Leerzeichen oder 1 Tab verschachtelt eine Unterliste, und derselbe Einzug hält andere Elemente innerhalb eines Listenpunkts: Ein Absatz oder ein Blockzitat braucht 4 Leerzeichen, ein Codeblock innerhalb einer Liste dagegen 8 Leerzeichen, weil der Standard-Codeeinzug von 4 Leerzeichen auf den Listeneinzug aufgeschlagen wird.
Best Practice: Bleiben Sie bei 1 Trennzeichen-Stil pro Liste und schließen Sie geordnete Zahlen mit Punkten statt Klammern ab, denn die Punktform funktioniert in jeder Markdown-Anwendung.
Code
Inline-Code steht zwischen einzelnen Backticks, und ein Codeblock ist jede Zeilenfolge, die um mindestens 4 Leerzeichen oder 1 Tab eingerückt ist.
Type `git status` to check the working tree.
<html>
<head></head>
</html>
Das Backtick-Paar rendert ein code-Element in nichtproportionaler Schrift, und der eingerückte Block landet in pre- und code-Tags, wobei jedes Leerzeichen erhalten bleibt. Ein Schnipsel, der selbst einen Backtick enthält, braucht doppelte Backticks darum, so zeigt the outer pair displays `code` literally das innere Zeichen wörtlich an. Umzäunte Codeblöcke mit dreifachen Backticks gehören zur erweiterten Syntax; der Einzug mit 4 Leerzeichen ist die ursprüngliche Methode.
Best Practice: Setzen Sie doppelte Backticks um wörtliche Backticks, damit das innere Zeichen gedruckt wird, statt den Code-Span vorzeitig zu schließen.
Horizontale Linien
Eine horizontale Linie verlangt 3 oder mehr Sternchen, Bindestriche oder Unterstriche allein auf einer eigenen Zeile.
***
---
___
Alle 3 Varianten rendern ein identisches hr-Element, einen Trenner über die volle Breite. Das Zeichen darf sich über 3 hinaus wiederholen, ohne die Ausgabe zu ändern, eine Zeile aus 20 Bindestrichen erzeugt also dieselbe Linie wie 3. Autoren setzen Linien für Szenenwechsel und Abschnittsgrenzen ein, wo eine Überschrift zu schwer wäre.
Best Practice: Lassen Sie über und unter jeder Linie eine Leerzeile, denn eine reine Bindestrich-Zeile direkt unter Text macht aus diesem Text stattdessen eine H2 Überschrift.
Links
Ein Inline-Link setzt den Linktext in eckige Klammern und direkt dahinter die URL in runden Klammern, plus einen optionalen Titel in Anführungszeichen.
Read the [original spec](https://daringfireball.net/projects/markdown/ "Gruber's 2004 spec").
Reference style keeps prose clean: read the [original spec][1].
[1]: https://daringfireball.net/projects/markdown/
Bare addresses work in angle brackets: <https://example.com> and <mail@example.com>
Jede Form rendert ein a-Element, und der Titeltext erscheint beim Überfahren als Tooltip. Referenz-Links trennen die URL vom Satz: Das Label [1] zeigt auf eine Definition, die irgendwo in der Datei stehen kann, ein Absatz voller langer URLs bleibt im Quelltext also lesbar. Spitze Klammern machen aus einer nackten URL oder E-Mail-Adresse einen klickbaren Link ohne zusätzlichen Text. Links akzeptieren auch Formatierung: Sternchen um die gesamte Konstruktion setzen den Link fett, und Backticks innerhalb der eckigen Klammern rendern ihn als Code.
Best Practice: Kodieren Sie jedes Leerzeichen in einer URL als %20, damit die vollständige Adresse in jedem Prozessor überlebt.
Bilder
Ein Bild verwendet ein Ausrufezeichen, dann Alt-Text in eckigen Klammern, dann den Bildpfad oder die URL in runden Klammern.
[](https://example.com/report)
Die erste Zeile rendert ein img-Element mit dem Alt-Text als Label für die Barrierefreiheit und dem Titel in Anführungszeichen als Hover-Text. Die Syntax entspricht einem Link mit 1 zusätzlichen Zeichen davor. Die zweite Zeile verschachtelt die gesamte Bildkonstruktion in einem Link, ein Klick auf das Bild öffnet also die Ziel-URL.
Best Practice: Schreiben Sie Alt-Text, der den Bildinhalt beschreibt, denn Screenreader und Suchmaschinen lesen ihn anstelle des Bildes.
Zeichen maskieren
Ein Backslash () vor einem Formatierungszeichen zeigt dieses Zeichen wörtlich an, statt seine Markdown-Funktion auszulösen.
\* This line shows a literal asterisk, not a bullet point.
1968\. The escaped period stops this year from starting an ordered list.
Der Backslash selbst erscheint nie in der Ausgabe; nur das Zeichen dahinter wird gedruckt. Markdown akzeptiert eine Backslash-Maskierung für 12 Zeichen: Backslash, Backtick, Sternchen, Unterstrich, geschweifte Klammern, eckige Klammern, runde Klammern, Rautezeichen, Pluszeichen, Minuszeichen, Punkt und Ausrufezeichen. Das zweite Beispiel oben löst eine typische Falle, denn jede Zeile, die mit einer Zahl und einem Punkt beginnt, wird ohne die Maskierung zum Listenpunkt.
Best Practice: Maskieren Sie nur die Zeichen aus dieser Liste von 12, denn ein Backslash vor jedem anderen Zeichen wird als sichtbarer Backslash gedruckt.
Häufig gestellte Fragen
Was ist die grundlegende Markdown Syntax?
Die grundlegende Syntax ist der Satz aus 11 Elementen aus John Grubers Markdown-Design-Dokument von 2004, und fast jede Markdown-Anwendung unterstützt ihn vollständig. Die 11 Elemente verhalten sich über alle Prozessoren hinweg konsistent, was den Basissatz zur sichersten Wahl für Dokumente macht, die zwischen Plattformen wandern.
Wie viele Überschriften-Ebenen unterstützt Markdown?
Markdown unterstützt 6 Überschriften-Ebenen, geschrieben mit 1 bis 6 Rautezeichen, und sie entsprechen direkt den HTML-Tags h1 bis h6. Die alternative Unterstreichungs-Syntax deckt nur die obersten 2 Ebenen ab: Gleichheitszeichen für eine H1 und Bindestriche für eine H2.
Wie füge ich einen Zeilenumbruch ein, ohne einen neuen Absatz zu beginnen?
Beenden Sie die Zeile mit 2 nachgestellten Leerzeichen oder mit dem HTML-Tag <br>. Beide Varianten rendern ein br-Element im aktuellen Absatz. Eine Leerzeile wirkt anders: Sie schließt den Absatz und öffnet einen neuen.
Reicht die grundlegende Syntax, oder brauche ich die erweiterte Syntax?
Die grundlegende Syntax deckt Standarddokumente ab, während die erweiterte Syntax Tabellen, umzäunte Codeblöcke, Fußnoten und weitere Elemente aus späteren Spezifikationen wie GFM ergänzt. Beginnen Sie für maximale Kompatibilität mit dem Basissatz und ergänzen Sie erweiterte Elemente, sobald die Zielplattform sie unterstützt.