Ratgeber zu Markdown Editor and Reader
Markdown Spickzettel: alle Befehle auf einen Blick
Markdown macht aus reinem Text mit ein paar Zeichen ein formatiertes Dokument. Dieser Spickzettel zeigt die Syntax in zwei Gruppen: den Kern, den jeder CommonMark-kompatible Renderer versteht, und die Erweiterungen aus GitHub Flavored Markdown (GFM), die die meisten modernen Editoren ebenfalls unterstützen.
Wenn etwas in deiner App nicht dargestellt wird, schau zuerst, zu welcher Gruppe es gehört. Tabellen, Checklisten und Durchstreichen sind nicht Teil von CommonMark selbst.
CommonMark: die Grundsyntax
Überschriften brauchen ein Leerzeichen nach den Rauten: # Titel ist eine Überschrift, #Titel nicht. Für Hervorhebungen mitten im Wort nimmst du Sternchen: un*glaub*lich wird in der Mitte kursiv, Unterstriche in Wörtern wie snake_case_name bleiben dagegen unverändert.
| Element | Syntax | Alternative |
|---|---|---|
| Überschrift 1 bis 6 | # Überschrift | ###### Überschrift |
| Fett | **fett** | __fett__ |
| Kursiv | *kursiv* | _kursiv_ |
| Fett und kursiv | ***fett kursiv*** | ___fett kursiv___ |
| Code im Text | `Code` – je ein Backtick davor und danach | zwei Backticks, wenn der Code selbst einen enthält |
| Link | [Text](https://example.com) | [Text](https://example.com "Titel") |
| Referenz-Link | [Text][1] | [1]: https://example.com |
| Bild |  |  |
| Automatischer Link | <https://example.com> | – |
| Zitat | > Zitat | >> verschachteltes Zitat |
| Aufzählung | - Punkt | * Punkt |
| Nummerierte Liste | 1. Punkt | 1) Punkt |
| Trennlinie | --- | *** |
| Harter Zeilenumbruch | zwei Leerzeichen am Zeilenende | ein Backslash am Zeilenende |
| Zeichen maskieren | \*nicht kursiv\* | geht für alle ASCII-Satzzeichen |
| Eingerückter Codeblock | jede Zeile um vier Leerzeichen einrücken | besser: Codeblock mit Backticks |
Erweiterungen aus GitHub Flavored Markdown
GFM ist eine Obermenge von CommonMark. GitHub, viele Static-Site-Generatoren und die meisten Markdown-Editoren unterstützen diese Erweiterungen. Fußnoten funktionieren auf GitHub und in vielen Editoren, gehören aber nicht zur GFM-Spezifikation – die Unterstützung ist daher unterschiedlich.
| Element | Syntax | Hinweis |
|---|---|---|
| Tabelle | | A | B | | Kopfzeile, dann eine Zeile wie | --- | --- | |
| Checkliste | - [ ] offen | - [x] erledigt |
| Durchgestrichen | ~~Text~~ | GFM akzeptiert auch eine einzelne Tilde |
| Link ohne Klammern | www.example.com | https://example.com |
| Fußnote (GitHub, nicht in der GFM-Spezifikation) | Text[^1] | [^1]: Die Anmerkung. |
Codeblöcke
Für mehrzeiligen Code setzt du drei Backticks in eine eigene Zeile vor und nach dem Code. Das Wort nach den öffnenden Backticks gibt die Sprache an; viele Renderer nutzen es für Syntax-Highlighting. Drei Tilden (~~~) funktionieren genauso.
```python
def gruss(name):
return f"Hallo, {name}"
```
Mit Markdown Editor and Reader geht's einfacherMehr erfahren →Verschachtelte Listen und Checklisten
Ein Unterpunkt muss so weit eingerückt sein, wie der Text des übergeordneten Punkts beginnt: zwei Leerzeichen unter - Punkt, drei unter 1. Punkt. Die Zahlen einer nummerierten Liste müssen nicht fortlaufend sein; der Renderer zählt ab der ersten Zahl weiter.
- Obst
- Apfel
- Birne
1. Erster Schritt
1. Unterschritt
- [x] Entwurf schreiben
- [ ] Korrektur lesenAlternative Überschriften
CommonMark akzeptiert auch „Setext“-Überschriften, die mit Gleichheitszeichen oder Bindestrichen unterstrichen werden. Sie gibt es nur für die Ebenen 1 und 2.
Überschrift 1
=============
Überschrift 2
-------------Typische Stolperfallen
- --- direkt unter einer Textzeile macht diese Zeile zur Überschrift. Lass über einer Trennlinie eine Leerzeile.
- Ein einfacher Zeilenumbruch im Absatz wird als Leerzeichen dargestellt. Beende die Zeile mit zwei Leerzeichen oder einem Backslash – oder beginne mit einer Leerzeile einen neuen Absatz.
- Lass zwischen Blöcken wie Absätzen, Listen, Tabellen und Codeblöcken eine Leerzeile. Das ist immer gültig und vermeidet Überraschungen in strengeren Renderern.
- HTML ist in CommonMark erlaubt, wird aber von vielen Apps und Websites aus Sicherheitsgründen gefiltert.
- Ein wörtliches *, _, # oder [ bekommst du mit einem Backslash davor.
Das Ergebnis direkt beim Schreiben sehen
Markdown Editor hebt Überschriften, Fett, Kursiv, Code, Links, Listen und Zitate schon beim Tippen hervor, und die Formatierungsleiste über der Tastatur fügt Überschriften, Listen, Checklisten, Links, Code, Zitate, Tabellen und Bilder mit einem Tipp ein. Ein Tipp aufs Auge öffnet die Vorschau mit Tabellen, Checklisten, verschachtelten Listen, Codeblöcken und Bildern; auf dem iPad stehen Text und Vorschau nebeneinander. Mit Markdown Editor Pro exportierst du ein Dokument schön formatiert als PDF oder HTML.
Häufige Fragen
Wie schreibe ich in Markdown fett und kursiv?
Mit **fett** für fett, *kursiv* für kursiv und ***Text*** für beides. Unterstriche (__fett__, _kursiv_) gehen auch, aber nicht mitten im Wort.
Was ist der Unterschied zwischen CommonMark und GitHub Flavored Markdown?
CommonMark ist eine genaue Spezifikation der Markdown-Grundsyntax. GitHub Flavored Markdown baut darauf auf und ergänzt Tabellen, Checklisten, Durchstreichen und automatische Links für nackte URLs.
Wie mache ich einen Zeilenumbruch ohne neuen Absatz?
Beende die Zeile mit zwei Leerzeichen oder einem Backslash. Ein einfacher Zeilenumbruch wird als Leerzeichen dargestellt, eine Leerzeile beginnt einen neuen Absatz.
HowlNight