Die komplette Markdown-Anleitung

Markdown ist eine leichtgewichtige Art, formatierten Text mit Zeichen zu schreiben, die du längst kennst — ein # für eine Überschrift, ein * für einen Aufzählungspunkt, ** um ein Wort, damit es fett wird. Du schreibst reinen Text, und daraus wird ein sauber gegliedertes Dokument. Diese Anleitung ist eine vollständige Referenz der Markdown-Syntax, von den Grundlagen für jeden Tag bis zu den Erweiterungen, die moderne Editoren beherrschen. Lass sie als Spickzettel offen, oder lies sie einmal von oben nach unten — danach kennst du praktisch alles.

Wenn Markdown ganz neu für dich ist, fang bei was Markdown ist und warum es sich lohnt an und komm für die Syntax hierher zurück.

Probier es gleich aus

Jedes Beispiel in dieser Anleitung ist lebendig. Tipp links, und rechts aktualisiert sich das Ergebnis beim Schreiben — nichts zu installieren, nichts anzumelden. Fang hier an:

# Mein erstes Dokument

Markdown ist **reiner Text**, der als *sauberes* Dokument erscheint.

- Ändere links irgendetwas
- Sieh zu, wie sich rechts alles mitschreibt
- Lösch diese Zeile und schreib deine eigene

> Ändere dieses Zitat. Oder setz eine `## Überschrift` darüber.

| Es geht  | in Tabellen |
|----------|-------------|
| und in   | Listen      |

Nichts, was du hier tippst, wird gespeichert oder verschickt — es lebt in deinem Browser und verschwindet, wenn du den Tab schließt.

Eine Anleitung pro Element

Diese Seite ist der Überblick. Jedes Element hat außerdem eine eigene Seite, mit einem Live-Editor für genau diese eine Sache und den Fallstricken, über die alle stolpern:

• Überschriften — die sechs Ebenen, Ankerlinks, eine H1 pro Dokument
• Fett und kursiv — Sternchen gegen Unterstriche, durchgestrichen
• Zeilenumbrüche und Absätze — warum einmal Enter nichts bewirkt
• Listen — verschachteln, nummerieren, eng gegen locker
• Links — inline, als Referenz und als Anker
• Bilder — Alternativtext, Größe, klickbare Bilder
• Codeblöcke — Zäune, Sprachen, Backticks zeigen
• Tabellen — Ausrichtung, Pipes escapen, die Grenzen
• Checklisten — Kästchen und wo sie anklickbar sind
• Zitate — verschachteln, Hinweiskästen, mehrere Absätze
• Trennlinien — Trenner und die Leerzeilenfalle
• Zeichen escapen — der Backslash und wann er überflüssig ist
• Fußnoten — Namen, Definitionen und wo sie funktionieren

Die Grundlagen

Die ursprüngliche Markdown-Syntax, 2004 von John Gruber festgelegt, deckt alles ab, was man zum Schreiben braucht. Alles hier unten ist universell — es funktioniert in praktisch jedem Markdown-Editor und auf jeder Plattform.

Überschriften

Setz #-Zeichen an den Anfang einer Zeile. Die Anzahl der # bestimmt die Ebene, von # (der größten, einer <h1>) bis ###### (einer <h6>).

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

Lass vor und nach einer Überschrift eine Leerzeile, damit jeder Editor sie richtig liest, und verwende ein einzelnes # nur einmal pro Dokument — das ist der Titel.

→ Alles über Überschriften — Ankerlinks, der Setext-Stil und warum nur eine H1.

Hervorhebung: fett, kursiv und mehr

Umschließe Text mit Zeichen, um ihn hervorzuheben:

*kursiv* oder _kursiv_

**fett** oder __fett__

***fett kursiv***

~~durchgestrichen~~

Bleib bei * für kursiv und ** für fett — die werden am breitesten unterstützt. Achte auf die Leerzeilen zwischen den vier Beispielen: ohne sie würde Markdown alle vier zu einem einzigen Absatz zusammenziehen, und das ist die häufigste Überraschung für Einsteiger. Lösch oben im Panel eine davon und sieh zu, wie es passiert.

→ Alles über Hervorhebung — Sternchen gegen Unterstriche und Hervorhebung mitten im Wort.

Absätze und Zeilenumbrüche

Eine Leerzeile beginnt einen neuen Absatz. Ein einzelner Zeilenumbruch nicht — Markdown behandelt ihn als Leerzeichen und zieht die Zeilen zusammen. Das ist das Erste, was alle überrascht.

Diese zwei Zeilen
werden ein Absatz.

Eine Leerzeile darüber beginnt einen neuen.

Zwei Leerzeichen am Ende  
erzwingen einen Umbruch im Absatz.

→ Alles über Zeilenumbrüche — die Zwei-Leerzeichen-Falle, der Backslash und wie GitHub abweicht.

Listen

Ungeordnete Listen nutzen -, * oder +. Geordnete Listen nutzen Zahlen mit einem Punkt. Rück um zwei Leerzeichen ein, um zu verschachteln.

- Erster Punkt
- Zweiter Punkt
  - Verschachtelt
  - Noch einer
- Dritter Punkt

1. Schritt eins
2. Schritt zwei
3. Schritt drei

Geordnete Listen musst du nicht richtig durchnummerieren — schreib in jeder Zeile 1. und es erscheint trotzdem als 1, 2, 3. Das macht das Umsortieren schmerzlos.

→ Alles über Listen — verschachteln, eng gegen locker und die Nummerierung.

Links

Setz den Linktext in eckige Klammern und die URL direkt danach in runde:

[Zur Markdown-Anleitung](https://www.inkiostro.app/de/markdown-anleitung)

Ein Titel geht auch: [zeig auf mich](https://www.inkiostro.app "Inkiostro")

Nackte URLs wie https://www.inkiostro.app werden in den meisten Editoren automatisch verlinkt. Für wiederkehrende Links hält der Referenzstil die Absätze lesbar:

Lies die [Anleitung][anl] und die [PDF-Tipps][pdf].

[anl]: https://www.inkiostro.app/de/markdown-anleitung
[pdf]: https://www.inkiostro.app/de/markdown-in-pdf

→ Alles über Links — Referenzlinks, Anker und sperrige URLs.

Bilder

Bilder sind Links mit einem Ausrufezeichen davor. Der Text in Klammern ist der Alternativtext — schreib ihn immer, für Barrierefreiheit und für Suchmaschinen.

![Ein Blatt Papier und ein Stift auf einem Schreibtisch](/images/desk.jpg)

→ Alles über Bilder — Alternativtext, Größe und klickbare Bilder.

Zitate

Beginn eine Zeile mit >. Zitate dürfen über mehrere Absätze gehen und anderes Markdown enthalten.

> Schreiben ist sichtbar gemachtes Denken.
>
> — jemand Kluges

→ Alles über Zitate — verschachteln, mehrere Absätze und Hinweiskästen.

Code

Für ein kurzes Stück mitten im Satz reichen einfache Backticks: `so hier`. Für einen ganzen Block zäunst du ihn mit drei Backticks ein. Der Sprachname nach dem öffnenden Zaun schaltet die Syntaxhervorhebung ein:

```js
function hello(name) {
  return `Hallo, ${name}`
}
```

function hello(name) {
  return `Hallo, ${name}`
}

→ Alles über Code — Zäune, Sprachen und wie man Backticks zeigt.

Trennlinie

Drei oder mehr Bindestriche, Sternchen oder Unterstriche in einer eigenen Zeile erzeugen einen Trenner:

---

→ Alles über Trennlinien — die Leerzeilenfalle und das Front Matter.

Zeichen escapen

Um ein Markdown-Zeichen wörtlich zu zeigen, setz einen Backslash davor. \*nicht kursiv\* erscheint als *nicht kursiv*.

→ Alles über das Escapen — die vollständige Liste und wann du es dir sparen kannst.

Erweiterte Syntax

Über die ursprüngliche Spezifikation hinaus beherrschen die meisten Werkzeuge Erweiterungen, bekannt geworden vor allem durch GitHub Flavored Markdown (GFM). Diese hier lohnen sich.

Tabellen

Bau eine Tabelle mit Pipes | und einer Trennzeile aus Bindestrichen. Doppelpunkte in der Trennzeile bestimmen die Ausrichtung der Spalte:

| Funktion  | Gratis | Pro |
|:----------|:------:|----:|
| Vorschau  |   ✓    |  ✓  |
| Export    |   ✓    |  ✓  |
| Fokusmodus|   —    |  ✓  |

Die Pipes müssen in deiner Quelle nicht bündig stehen — ein Editor mit Live-Vorschau setzt die Tabelle so oder so sauber.

→ Alles über Tabellen — Ausrichtung, Pipes escapen und was Tabellen nicht können.

Checklisten

Kästchen sind ein Listenpunkt mit [ ] oder [x]:

- [x] Entwurf schreiben
- [ ] Überarbeiten
- [ ] Als PDF exportieren

→ Alles über Checklisten — verschachteln und wo die Kästchen anklickbar sind.

Codezaun mit Sprache

Wie oben gezeigt: Der Sprachname nach dem öffnenden Zaun (```python, ```bash, ```json) schaltet die Syntaxhervorhebung in der Vorschau und im Export ein.

Fußnoten

Setz einen Verweis in den Text und definier ihn irgendwo im Dokument:

Markdown entstand 2004.[^1]

[^1]: Von John Gruber, mit Beiträgen von Aaron Swartz.

→ Alles über Fußnoten — Namen, mehrere Absätze und die Unterstützung.

Automatische Links und Durchgestrichenes

GFM verlinkt nackte URLs und E-Mail-Adressen von selbst, und ~~Text~~ wird durchgestrichen — beides weiter oben schon zu sehen.

CommonMark, GFM und die anderen Dialekte

Weil Grubers ursprüngliche Beschreibung einige Randfälle offen ließ, entstand CommonMark, um Markdown genau zu definieren. Die meisten modernen Editoren folgen CommonMark und legen dann Erweiterungen darüber. GitHub Flavored Markdown ist CommonMark plus Tabellen, Checklisten, Durchgestrichenes und automatische Links. Manche Werkzeuge gehen weiter, mit LaTeX-Formeln und Diagrammen — siehe Formeln in Markdown schreiben und Diagramme aus reinem Text.

In der Praxis: Lern die Grundlagen und die GFM-Erweiterungen von oben, und deine Dokumente erscheinen fast überall richtig.

Markdown-Spickzettel

Alles auf einem Bildschirm — setz ein Lesezeichen auf diese Tabelle.

Tipps für besseres Markdown

• Lass Leerzeilen zwischen Blockelementen (Überschriften, Absätze, Listen). Das ist die häufigste Antwort auf „warum wird das nicht dargestellt?".
• Nutz eine Live-Vorschau. Das Ergebnis beim Tippen zu sehen findet Fehler sofort und lässt dich bei den Worten bleiben.
• Bleib portabel. Nimm lieber die universelle Syntax und die GFM-Erweiterungen von oben; meide Eigenheiten einzelner Werkzeuge, damit deine Dateien überall sauber aufgehen.
• Schreib Alternativtexte zu jedem Bild.
• Ein # pro Datei. Behandle es als Dokumenttitel und gliedere den Rest mit ## und ###.

Ein guter Editor macht das alles mühelos — eine Formatierungsleiste fügt die richtigen Zeichen ein, die Syntaxhervorhebung hält lange Dateien lesbar, und die Live-Vorschau zeigt das Ergebnis. Inkiostro macht genau das auf Mac, iPad und iPhone und hat den Spickzettel selbst einen Tastendruck entfernt eingebaut.

Häufige Fragen

Ist Markdown schwer zu lernen?

Nein. Das Wesentliche — Überschriften, fett, kursiv, Listen und Links — lernst du in ein paar Minuten, und das deckt den Alltag ab. Den Rest nimmst du mit, wenn du ihn brauchst. Markdown wurde ausdrücklich so entworfen, dass es schon als reiner Text lesbar ist, deshalb ist selbst die rohe Syntax leicht zu verfolgen.

Was ist der Unterschied zwischen Markdown und CommonMark?

Markdown ist die ursprüngliche Syntax von John Gruber aus dem Jahr 2004. CommonMark ist eine strenge, eindeutige Spezifikation genau dieser Syntax, damit jeder Editor dieselbe Eingabe gleich darstellt. Die meisten modernen Werkzeuge folgen CommonMark und legen Erweiterungen wie Tabellen und Checklisten darüber.

Taugt Markdown auch für mehr als Notizen?

Ja. Markdown wird für Dokumentation, Blogbeiträge, Bücher, README-Dateien, wissenschaftliche Texte mit Formeln und vieles mehr benutzt. Mit Erweiterungen kommen Tabellen, Fußnoten, LaTeX-Gleichungen und Diagramme dazu, und dann exportierst du nach PDF, HTML oder EPUB — aus einer Textnotiz wird ein fertiges Dokument.

Wie wandle ich Markdown in ein PDF oder ein Word-Dokument um?

Nimm einen Markdown-Editor mit Export. Inkiostro exportiert nach PDF, HTML, TXT und Markdown (und auf dem Mac nach EPUB), mit Kontrolle über Kopfzeile, Fußzeile und Ränder — die Anleitung Markdown zu PDF führt Schritt für Schritt hindurch.

Welche Zeichen muss ich in Markdown escapen?

Setz einen Backslash vor jedes Zeichen, das wörtlich erscheinen statt gedeutet werden soll — meistens *, _, #, `, [, ], (, ) und \. \*Stern\* zeigt zum Beispiel die Sternchen an, statt das Wort kursiv zu setzen.