Markdown Syntax Guide — Vollständige Übersicht aller Elemente
Markdown hat eine elegante, intuitive Syntax, die man in wenigen Stunden lernen kann. Dieser Guide ist eine vollständige Referenz aller Markdown-Elemente — von den Grundlagen bis zu erweiterten Features wie Tabellen, Fußnoten und Code-Blöcken mit Syntax-Highlighting. Alle Beispiele können sofort im WikiPlus Markdown-Vorschau-Tool ausprobiert werden.
Überschriften, Absätze und Zeilenumbrüche
Überschriften werden mit Rauten-Zeichen erstellt: # H1 erzeugt eine H1-Überschrift, ## H2 eine H2, bis zu ###### H6. Es gibt auch eine alternative Syntax mit Unterstreichungen: H1-Text auf einer Zeile, darunter === (beliebig viele Gleichheitszeichen). H2 analog mit ---. Absätze entstehen durch eine Leerzeile zwischen Textblöcken. Einfache Zeilenumbrüche ohne Leerzeile werden von Markdown-Prozessoren zusammengeführt. Für einen erzwungenen Zeilenumbruch ohne neuen Absatz: Zwei Leerzeichen am Zeilenende einfügen (nicht immer empfohlen — schlecht sichtbar). Besser: HTML <br> verwenden, wenn wirklich nötig. Leerabsätze können mit zwei oder mehr Leerzeilen erstellt werden, aber Standard sind genau eine Leerzeile zwischen Absätzen. Der WikiPlus Markdown-Vorschau-Tool zeigt alle diese Varianten in Echtzeit und ist ideal zum Ausprobieren der Syntax.
Listen, verschachtelte Listen und Task-Listen
Ungeordnete Listen: Mit -, + oder * am Anfang der Zeile. - Element 1. - Element 2. - Element 3. Geordnete Listen: Mit Zahlen gefolgt von einem Punkt. 1. Erster Schritt. 2. Zweiter Schritt. 3. Dritter Schritt. Interessant: Die tatsächliche Zahl spielt keine Rolle — auch 1. 1. 1. erzeugt korrekte 1, 2, 3 Nummerierung. Verschachtelte Listen durch Einrückung: 2 oder 4 Leerzeichen vor dem Listenpräfix. - Elternelement. -- Unterlement (2 Leerzeichen Einrückung). Task-Listen (GFM): - [x] Erledigte Aufgabe. - [ ] Offene Aufgabe. Diese werden auf GitHub als interaktive Checkboxen gerendert. Für normale Markdown-Renderer werden sie als Liste mit [x] oder [ ] angezeigt. Listen können mit Absätzen gemischt werden: wenn Listenelemente durch Leerzeilen getrennt sind, werden sie als Absätze gerendert (mit <p>-Tags umgeben).
Code-Blöcke, Inline-Code und Syntax-Highlighting
Code ist eines der häufigsten Elemente in technischer Markdown-Dokumentation. Inline-Code: Mit einfachen Backticks — `code` — erzeugt eingebetteten Code im Fließtext. Nützlich für Variablennamen, Befehle und kurze Code-Fragmente. Code-Blöcke: Mit drei Backticks (```) als Einleitung und Abschluss. Zwischen den Backticks kann eine Sprachen-Angabe für Syntax-Highlighting stehen: ```javascript. Beispiel: ```javascript const greeting = 'Hello, World!'; console.log(greeting); ```. Unterstützte Sprachen für Syntax-Highlighting (je nach Renderer): javascript, typescript, python, bash, sql, css, html, json, yaml, markdown und viele mehr. Alternative Code-Block-Syntax: Jede Zeile mit 4 Leerzeichen einrücken — ältere Methode, weniger empfohlen als die Backtick-Methode. Eingebettete Backticks: Wenn Code selbst Backticks enthält, den Block mit doppelten Backticks umschließen: `` `inline code mit Backtick` ``.
Tabellen, Fußnoten und fortgeschrittene Syntax
Tabellen sind eine GFM-Erweiterung und in vielen Tools verfügbar: | Spalte 1 | Spalte 2 | Spalte 3 | | --- | --- | --- | | Wert A | Wert B | Wert C | | Wert D | Wert E | Wert F |. Der zweite Zeile definiert die Spalten-Ausrichtung: |---| für standard, |:---| für linksbündig, |---:| für rechtsbündig, |:---:| für zentriert. Tabellen in Markdown sind syntaktisch etwas umständlich — für komplexe Tabellen sind HTML-Tabellen-Syntax innerhalb von Markdown oft praktischer. Fußnoten (GFM und einige andere Varianten): Text mit Fußnotenreferenz[^1]. Am Ende des Dokuments: [^1]: Fußnotentext. Werden als hochgestellte Zahlen im Text und Referenzliste am Ende gerendert. Horizontale Linien: ---, ***, oder ___ (drei oder mehr Zeichen). Blockquotes: > am Zeilenanfang. Verschachtelte Blockquotes: >> für zweite Ebene. Definitionen (MultiMarkdown/Pandoc): Begriff : Definition — nicht in Standard-Markdown.
Häufig gestellte Fragen
- Wie füge ich ein Bild in Markdown ein?
- Syntax: . Für ein lokal verlinktes Bild: . Die Bildgröße kann in Standard-Markdown nicht direkt gesetzt werden — dafür muss HTML verwendet werden: <img src='url.jpg' alt='Alt-Text' width='300'>.
- Kann ich HTML direkt in Markdown verwenden?
- Ja, in den meisten Markdown-Prozessoren kann HTML direkt eingebettet werden. Nützlich für Elemente wie <details><summary>Klicken</summary>Inhalt</details> für Klapp-Elemente, die Markdown nicht nativ unterstützt. In einigen sicherheitsorientierten Renderern (z.B. auf GitHub) wird HTML aus Sicherheitsgründen gefiltert.
- Wie erstelle ich einen Link, der in einem neuen Tab öffnet?
- Standard-Markdown bietet keine Syntax für target='_blank'. Man muss HTML verwenden: <a href='https://url.de' target='_blank' rel='noopener noreferrer'>Linktext</a>. Die rel='noopener noreferrer'-Attribute sind aus Sicherheitsgründen empfohlen.