Markdown Spickzettel: Alle 21 Syntax-Elemente auf einer Seite
Ein Markdown Spickzettel ist eine einseitige Referenz, die jedes Markdown-Element mit seiner exakten Syntax verbindet, damit Sie ein Dokument formatieren können, ohne in der vollständigen Dokumentation nachschlagen zu müssen. Dieses Markdown Cheat Sheet deckt alle 21 Elemente in zwei Tabellen ab: die 10 Basis-Elemente, die John Gruber in der ursprünglichen Spezifikation von 2004 definiert hat, und die 11 erweiterten Elemente, die spätere Varianten wie CommonMark (2014) und GitHub Flavored Markdown (2017) ergänzt haben. Jedes Syntax-Beispiel dieser Markdown Syntax Übersicht funktioniert auch im Online-Markdown-Editor, wo die Live-Vorschau das gerenderte Ergebnis anzeigt, während Sie tippen.
Basis-Syntax
Die Basis-Syntax umfasst die 10 Elemente aus dem ursprünglichen Markdown-Design von 2004, und jede Markdown-Anwendung rendert sie identisch. Diese 10 Elemente erledigen den Großteil des alltäglichen Schreibens: Struktur entsteht durch Überschriften und Listen, Betonung durch Fett und Kursiv, und Verweise durch Links und Bilder. Wenn ein Dokument nur die Zeilen dieser Tabelle nutzt, wird es auf GitHub, in Obsidian, auf Reddit, in Discord und in jedem nach 2004 entwickelten Editor korrekt dargestellt.
| Element | Syntax | Gerendertes Ergebnis |
|---|---|---|
| Überschrift | # H1 / ## H2 / ### H3 | Abschnittstitel der Ebenen 1 bis 6; ein # pro Ebene |
| Fett | **strong words** | fette Wörter |
| Kursiv | *slanted words* | kursive Wörter |
| Zitatblock | > quoted line | Eingerückter Zitatblock mit linkem Rand |
| Nummerierte Liste | 1. Step one 2. Step two | Nummerierte Liste; die Nummerierung wird fortlaufend gerendert |
| Aufzählungsliste | - First point - Second point | Liste mit Aufzählungspunkten; * und + funktionieren ebenfalls als Marker |
| Code | `inline code` | Inline-Code in einer Box mit fester Zeichenbreite |
| Horizontale Linie | --- | Trennlinie in voller Breite zwischen Abschnitten |
| Link | [anchor text](https://example.com) | Klickbarer Hyperlink mit der Beschriftung "Ankertext" |
| Bild |  | Eingebettetes Bild mit Alt-Text für Barrierefreiheit |
Der Überschriften-Marker braucht ein Leerzeichen nach dem letzten #, und die horizontale Linie braucht eine Leerzeile darüber. Diese zwei Details verursachen die meisten Rendering-Fehler in der Basis-Syntax.
Erweiterte Syntax
Die erweiterte Syntax ergänzt 11 Elemente, die in der ursprünglichen Spezifikation von 2004 nie enthalten waren, und die Unterstützung hängt davon ab, welche Markdown-Variante eine Anwendung implementiert. Tabellen, abgegrenzte Codeblöcke und Aufgabenlisten kamen mit GitHub Flavored Markdown, das GitHub 2017 als Spezifikation formalisiert hat. Fußnoten, Definitionslisten und Hervorhebung stammen aus anderen Varianten und werden in weniger Anwendungen gerendert.
| Element | Syntax | Gerendertes Ergebnis |
|---|---|---|
| Tabelle | | Name | Role | | --- | --- | | Ada | Engineer | | Raster mit Kopfzeile und ausgerichteten Spalten |
| Abgegrenzter Codeblock | ```json { "id": 1 } ``` | Mehrzeilige Code-Box mit optionaler Syntax-Hervorhebung |
| Fußnote | A claim.[^1] [^1]: The source. | Nummerierter Verweis mit einer Anmerkung am Seitenende |
| Überschriften-ID | ## Pricing {#pricing} | Überschrift mit eigenem Anker für direkte Links |
| Definitionsliste | Term : Meaning of the term | Begriff in einer Zeile, eingerückte Definition darunter |
| Durchgestrichen | ~~old figure~~ | |
| Aufgabenliste | - [x] Ship the draft - [ ] Review edits | Checkliste mit abgehakten und offenen Kästchen |
| Emoji-Shortcode | :tada: | Das passende Emoji-Zeichen, 🎉 |
| Hervorhebung | ==key phrase== | Textstelle auf farbigem Hintergrund |
| Tiefgestellt | H~2~O | H₂O |
| Hochgestellt | x^2^ | x² |
Die Unterstützung variiert je nach Anwendung: GitHub rendert Tabellen, abgegrenzte Codeblöcke, Aufgabenlisten, Durchgestrichenes, Fußnoten und Emoji-Shortcodes, ignoriert aber Hervorhebung, Tiefgestelltes und Hochgestelltes; Obsidian beherrscht Tabellen, Fußnoten, Aufgabenlisten, Durchgestrichenes und Hervorhebung; Discord akzeptiert Fett, Kursiv, Durchgestrichenes und Codeblöcke, bietet aber keine Unterstützung für Tabellen oder Fußnoten. Wenn die Zielplattform unbekannt ist, sind die 10 Basis-Elemente die sichere Wahl.
So nutzen Sie diesen Spickzettel
Suchen Sie das Element in der linken Spalte, kopieren Sie die Syntax aus der mittleren Spalte und ersetzen Sie den Platzhaltertext durch Ihren eigenen Inhalt. Die Spalte mit dem gerenderten Ergebnis zeigt, wie die Ausgabe aussieht, damit Sie vor dem Kopieren prüfen können, ob das Element Ihrer Absicht entspricht. Bei allem aus der erweiterten Tabelle sollten Sie zuerst den Hinweis zur Unterstützung lesen; eine Fußnote, die auf GitHub gerendert wird, verschwindet auf Discord.
Der schnellste Weg, Markdown Syntax zu überprüfen, ist sie in den Online-Markdown-Editor einzufügen. Die Live-Vorschau rendert jedes Element innerhalb von Millisekunden, sodass eine kaputte Tabelle oder ein nicht geschlossener **-Marker sofort sichtbar wird. Wer täglich in Markdown schreibt, hat die Basis-Tabelle meist innerhalb einer Woche im Kopf; die erweiterte Tabelle ist der Teil, den man griffbereit halten sollte.
Herunterladen und ausdrucken
Dieser Spickzettel passt auf eine A4-Seite und ist als .md-Datei verfügbar, sodass Sie eine Kopie in Ihrer eigenen Notiz-App aufbewahren oder für Ihren Schreibtisch ausdrucken können. Die heruntergeladene Datei ist selbst gültiges Markdown, und beide Tabellen werden in jeder Anwendung korrekt gerendert, die GFM-Tabellen unterstützt. Öffnen Sie sie im Editor, in Obsidian oder in einem GitHub-Repository, und die Referenz bleibt formatiert.
Häufig gestellte Fragen
Was ist der Unterschied zwischen der Markdown Basis-Syntax und der erweiterten Syntax?
Basis-Syntax bezeichnet die 10 Elemente aus der ursprünglichen Spezifikation von 2004, erweiterte Syntax die 11 Elemente, die spätere Varianten ergänzt haben. Jede Markdown-Anwendung unterstützt den Basis-Satz. Der erweiterte Satz hängt von der Variante ab: CommonMark hat 2014 das Kernverhalten standardisiert, und GFM hat in seiner Spezifikation von 2017 Tabellen, Aufgabenlisten und Durchgestrichenes ergänzt.
Unterstützen alle Markdown-Anwendungen die erweiterte Syntax?
Nein. Die Unterstützung der erweiterten Syntax unterscheidet sich je nach Anwendung, und keine einzelne App rendert alle 11 erweiterten Elemente. GitHub lässt Hervorhebung und Tiefgestelltes aus, Discord lässt Tabellen und Fußnoten aus, und Obsidian deckt von den dreien die größte Bandbreite ab. Dokumente für mehrere Plattformen sollten sich auf die Basis-Syntax plus GFM-Tabellen stützen.
Ist Markdown schwer zu lernen?
Nein. Markdown hat insgesamt 21 Elemente, und die 10 Basis-Elemente decken die meisten Dokumente ab. Ein # für Überschriften, ** für Fett und - für Listen machen den Großteil der realen Nutzung aus. Die meisten Menschen schreiben nach einer einzigen Sitzung mit einem Live-Vorschau-Editor flüssiges Markdown, weil die Vorschau Fehler sofort sichtbar macht.