Referenz

Markdown Spickzettel

Jede Markdown-Regel, die Sie brauchen — links die Syntax, rechts das gerenderte Ergebnis. Deckt CommonMark und die GitHub-Flavored-Markdown-Erweiterungen ab.

Überschriften

Sechs Ebenen. Lassen Sie eine Leerzeile vor einer Überschrift, damit sie nicht vom Absatz darüber verschluckt wird.

Syntax

Ergebnis

Überschrift erster Ebene

# Heading level 1

Heading level 1

Abschnittsüberschrift

## Heading level 2

Heading level 2

Unterabschnitt

### Heading level 3

Heading level 3

Alternative Schreibweise für Ebene 1 und 2

Heading level 1
===============

Heading level 2
---------------

Heading level 1

Heading level 2

Hervorhebung

Sternchen und Unterstriche funktionieren beide. Innerhalb von Wörtern sind Sternchen sicherer.

Syntax

Ergebnis

Fett

**bold text**

bold text

Kursiv

*italic text*

italic text

Fett und kursiv

***bold and italic***

bold and italic

Durchgestrichen (GFM)

~~struck through~~

~~struck through~~

Listen

Zum Verschachteln um zwei Leerzeichen einrücken. Nummerierte Listen zählen selbst hoch — Sie können durchgehend 1. schreiben.

Syntax

Ergebnis

Aufzählung

- First item
- Second item
- Third item

First item
Second item
Third item

Nummerierte Liste

1. First item
1. Second item
1. Third item

First item
Second item
Third item

Verschachtelte Liste

- Parent item
  - Child item
    - Grandchild item

Parent item
- Child item
  - Grandchild item

Aufgabenliste (GFM)

- [x] Finished task
- [ ] Open task

xFinished task
Open task

Links und Bilder

Ein Bild ist ein Link mit vorangestelltem Ausrufezeichen. Der Alt-Text zählt für Barrierefreiheit und SEO.

Syntax

Ergebnis

Inline-Link

[Markdown to Image](https://markdowntoimage.com)

Markdown to Image

Link mit Tooltip

[Markdown to Image](https://markdowntoimage.com "Convert Markdown")

Markdown to Image

Bild

![A mountain at dusk](/photo.jpg)

A mountain at dusk

Automatischer Link

<https://markdowntoimage.com>

https://markdowntoimage.com

Code

Schreiben Sie die Sprache hinter die öffnenden Backticks, um Syntaxhervorhebung zu erhalten.

Syntax

Ergebnis

Inline-Code

Run `npm install` first.

Run npm install first.

Codeblock

```
plain code block
```

plain code block

Codeblock mit Hervorhebung

```js
const total = items.length;
```

const total = items.length;

Zitate

Zitate können jedes andere Markdown enthalten, auch Listen und Code.

Syntax

Ergebnis

Zitat

> Everything should be made as
> simple as possible.

Everything should be made as simple as possible.

Verschachteltes Zitat

> Outer quote
>
>> Inner quote

Outer quote
Inner quote

Tabellen

Die Spalten müssen im Quelltext nicht ausgerichtet sein. Doppelpunkte in der Trennzeile legen die Ausrichtung fest.

Syntax

Ergebnis

Einfache Tabelle

| Format | Size |
| --- | --- |
| PNG | 240 KB |
| PDF | 96 KB |

Format	Size
PNG	240 KB
PDF	96 KB

Spaltenausrichtung

| Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c |

Left	Center	Right
a	b	c

Weitere Syntax

Drei oder mehr Bindestriche ergeben eine Trennlinie. Zwei Leerzeichen am Zeilenende erzwingen einen Umbruch ohne neuen Absatz.

Syntax

Ergebnis

Trennlinie

---

Harter Zeilenumbruch

First line ends here.\
Second line starts here.

First line ends here.
Second line starts here.

Sonderzeichen maskieren

\*not italic\*

*not italic*

Fußnote (GFM)

Text with a note.[^1]

[^1]: The note itself.

Text with a note.¹

Fehlerbehebung

Support

Was ist der Unterschied zwischen Markdown und GitHub Flavored Markdown?

GitHub Flavored Markdown (GFM) ist eine Obermenge von CommonMark. Es ergänzt Tabellen, Aufgabenlisten, Durchstreichen, Fußnoten und automatische URL-Verlinkung. Alles auf dieser Seite mit GFM gekennzeichnete benötigt einen Renderer, der diese Erweiterungen unterstützt — die meisten modernen tun das.

Warum wird meine Überschrift nicht dargestellt?

Meist fehlt das Leerzeichen nach den Rauten. Schreiben Sie # Überschrift, nicht #Überschrift. Der zweite Grund ist eine fehlende Leerzeile darüber, wodurch manche Parser sie als Teil des vorherigen Absatzes behandeln.

Wie erzeuge ich einen Zeilenumbruch ohne neuen Absatz?

Beenden Sie die Zeile mit zwei Leerzeichen oder setzen Sie einen Backslash ans Zeilenende. Ein einzelner Zeilenumbruch wird von den meisten Parsern zu einem Leerzeichen zusammengefasst, eine Leerzeile beginnt dagegen einen neuen Absatz.

Wie zeige ich ein Sternchen oder einen Unterstrich wörtlich an?

Setzen Sie einen Backslash davor. \*Text\* wird als *Text* dargestellt, statt kursiv zu werden. Das Gleiche gilt für Backticks, Rauten, Klammern und andere Markdown-Zeichen.

Müssen die Spalten in Markdown-Tabellen ausgerichtet sein?

Nein. Die Striche müssen im Quelltext nicht bündig stehen — das Layout übernimmt der Renderer. Ausrichten macht die Rohdatei nur lesbarer. Entscheidend ist die Trennzeile unter der Kopfzeile.