Überschriften (Kern)
Beginne die Zeile mit einem bis sechs #-Zeichen, dann einem Leerzeichen. Mehr #-Zeichen bedeuten eine kleinere Überschrift.
# Title
## Section
### Subsection
Das Leerzeichen ist wichtig. Sieben #-Zeichen sind keine Überschrift.
Absätze und Zeilenumbrüche (Kern)
Eine Leerzeile beginnt einen neuen Absatz. Ein einzelner Zeilenumbruch innerhalb eines Absatzes bricht die Zeile nicht um. Der Text läuft weiter.
Für einen Zeilenumbruch ohne neuen Absatz beendest du die Zeile mit zwei Leerzeichen oder einem Backslash:
First line\
Second line
Fett, kursiv und durchgestrichen
*italic* or _italic_
**bold** or __bold__
***bold and italic***
~~strikethrough~~
Kursiv und fett gehören zum Kern. Durchgestrichen gehört zu GFM. Verwende die Sternchen, wenn das Zeichen mitten in einem Wort steht, denn _ funktioniert innerhalb eines Wortes nicht.
Listen
- Apples
- Bananas
- Green ones
- Yellow ones
1. Wake up
2. Make tea
3. Read
- [ ] Write the draft
- [x] Send the draft
Aufzählungspunkte können mit -, + oder * beginnen. Nummerierte Listen verwenden eine Zahl und ein . oder ). Die erste Zahl bestimmt, wo die Liste beginnt.
Um eine Liste zu verschachteln, rücke die innere Liste so ein, dass sie am Text des Eintrags darüber ausgerichtet ist. Bei - Bananas sind das zwei Leerzeichen.
Aufzählungspunkte und Nummern gehören zum Kern. Aufgabenlisten, die Kästchen [ ] und [x], gehören zu GFM.
Links
[PilcrowMD](https://pilcrowmd.com "Optional title")
<https://pilcrowmd.com>
https://pilcrowmd.com
Der erste ist ein Inline-Link: Text in eckigen Klammern, Adresse in runden Klammern. Der zweite ist ein Autolink in spitzen Klammern. Beide gehören zum Kern.
Der dritte ist eine bloße Adresse ohne Zeichen. CommonMark macht daraus keinen Link. GFM schon, für Adressen, die mit http://, https:// oder www. beginnen.
Links zu einer Überschrift
Um zu einer Überschrift in derselben Datei zu springen, verlinke ihren Anker:
## My first section
[Go to the section](#my-first-section)
Der Link ist ein normaler Inline-Link. Der Anker wird auf GitHub aus dem Überschriftentext gebildet: Kleinbuchstaben, Leerzeichen werden zu Bindestrichen, übrige Satzzeichen werden entfernt. Eine zweite Überschrift mit demselben Text erhält ein angehängtes -1. Andere Apps bilden Anker möglicherweise genauso, aber es ist eine GitHub-Regel, also testest du es.
Bilder
Wie ein Link, mit einem ! davor:

Der Text in eckigen Klammern ist die Beschreibung (der Alternativtext). Die Bildsyntax gehört zum Kern.
Zitate (Kern)
Beginne jede Zeile mit >:
> The best way to learn is to try.
Code
Für ein kurzes Stück Code innerhalb eines Satzes verwendest du einfache Backticks:
Run `npm test` before you commit.
Um einen Backtick im Code anzuzeigen, setze den Code in doppelte Backticks.
Für einen Block verwendest du einen Zaun aus drei Backticks. Schreibe den Namen der Sprache hinter den öffnenden Zaun:
```python
print("Hello")
```
Zäune lassen sich auch mit drei Tilden ~~~ bilden. Der Name der Sprache ist optional. Apps nutzen ihn, um den Code einzufärben. All das gehört zum Kern.
Horizontale Linie (Kern)
Drei oder mehr -, * oder _ allein in einer Zeile:
---
Lass über --- eine Leerzeile. Direkt unter einer Textzeile macht es diesen Text stattdessen zu einer Überschrift.
Tabellen (GFM)
Eine Tabelle braucht eine Kopfzeile, eine Strichzeile und Datenzeilen:
| Fruit | Price |
|--------|-------|
| Apple | 1.20 |
Tabellen haben weitere Regeln, etwa Ausrichtung und das Maskieren des senkrechten Strichs. Siehe Markdown-Tabellen: So schreibst und liest du sie.
Maskieren: ein Zeichen als Text anzeigen (Kern)
Setze einen Backslash vor ein Zeichen, um es als einfachen Text anzuzeigen:
\*not italic\*
Jedes Satzzeichen lässt sich so maskieren. Backslashes funktionieren innerhalb von Code nicht.
Fußnoten (GitHub-Funktion)
This claim needs a source.[^1]
[^1]: Here is the source.
Fußnoten stehen weder in CommonMark noch in der GFM-Spezifikation. GitHub unterstützt sie. Der Text der Fußnote erscheint am Ende der Seite, egal wo du ihn in der Datei schreibst. GitHub unterstützt Fußnoten in Wikis nicht.
Hinweisboxen (GitHub-Funktion)
Eine Hinweisbox ist ein Zitat mit einer Beschriftung in der ersten Zeile:
> [!NOTE]
> Useful information the reader should know.
Die Typen sind NOTE, TIP, IMPORTANT, WARNING und CAUTION. Sie stehen in keiner der beiden Spezifikationen. Setze sie sparsam ein.
Markdown lesen
In einem einfachen Texteditor bleiben alle diese Zeichen sichtbar. Ein Markdown-Leser macht daraus eine saubere Seite.
PilcrowMD zeigt Tabellen, Fußnoten, Hinweisboxen im GitHub-Stil und Links, die zu einer Überschrift springen, auf Android und Mac. Auf dem Mac zeigt es außerdem Aufgabenlisten.
Häufige Fragen
Welches Markdown sollte ich zuerst lernen? Die Kernzeichen: Überschriften, fett, kursiv, Listen, Links, Code und Zitate. Sie funktionieren in jeder Markdown-App. Füge als Nächstes Tabellen und Aufgabenlisten hinzu, denn die meisten Apps unterstützen GFM.
Warum sieht mein Markdown in einer anderen App anders aus? Apps folgen unterschiedlichen Regeln. CommonMark ist die Basis, GFM ergänzt sie, und manche Funktionen, etwa Fußnoten und Hinweisboxen, stehen in keinem von beiden. Wenn ein Zeichen nicht funktioniert, unterstützt die App es wahrscheinlich nicht.
Muss ich nach # und - Leerzeichen setzen? Ja. Schreibe # Title und - Item. Ohne das Leerzeichen bleibt die Zeile einfacher Text.
Auch für Mac: PilcrowMD für Mac (Beta)