Markdown-Tabellen: die komplette Referenz

Alles zu GFM-Pipe-Tabellen (GitHub-Flavor) — Anatomie, Ausrichtung, Escaping, die Fehler, die das Rendering brechen, und das Bewegen von Tabellen zwischen Werkzeugen.

Grundsyntax

| Column A | Column B |
|----------|----------|
| cell 1   | cell 2   |
| cell 3   | cell 4   |

Drei Teile: eine Kopfzeile, eine Trennzeile (mindestens Bindestriche), dann die Datenzeilen. Die Trennzeile muss existieren — ohne sie ist der Text ein Absatz, keine Tabelle. Die Abstände in der Quelle müssen sich nicht ausrichten; auf Pipes kommt es an, nicht auf Spalten. Führende und nachgestellte Pipes sind optional, aber aus Gründen der Portabilität empfohlen.

Ausrichtung

Doppelpunkte in der Trennzeile legen die Spaltenausrichtung fest — :--- links (der Standard), :---: zentriert, ---: rechts:

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

Ausrichtung ist die einzige Kontrolle auf Zellebene, die GFM bietet: kein Zellenhintergrund, keine verbundenen Zellen, kein Spalten-Spanning.

Inline-Formatierung in Zellen

Zellen akzeptieren Inline-Markdown — fett, kursiv, Inline-Code und Links — aber keine Blockelemente: keine Listen, keine Überschriften und keine verschachtelten Tabellen in einer Zelle. Jede Zeile ist eine Quellzeile; lange Umbrüche brauchen ein explizites <br>.

Häufige Fehler, die Tabellen brechen

Keine Leerzeile vor der Tabelle — direkt an einen Absatz geklebt, behandeln die meisten Parser die Pipes als Text.
Fehlerhafte Trennzeile — sie darf nur Bindestriche, Doppelpunkte und Pipes enthalten, mit exakt so vielen Zellen wie die Kopfzeile.
Nicht escapete Pipe in einer Zelle — ein literales | spaltet die Zelle und verschiebt jede folgende Spalte. Als \| escapen.
Zeilen unterschiedlicher Länge — GitHub toleriert fehlende Zellen am Zeilenende (und rendert sie leer), aber manche Parser und Konverter bemängeln oder paddingen sie; halten Sie die Zeilenlängen konsistent.
Eingerückte Tabellen — vier führende Leerzeichen machen aus dem ganzen Block ein Code-Fence.

Fügen Sie eine verdächtige Tabelle in den Tabellengenerator ein — er normalisiert Ausrichtung und Escaping in die kanonische Form.

Tabellen in andere Werkzeuge hinein und aus ihnen heraus

Richtung	Werkzeug	Hinweise
Excel / Sheets → Markdown	Excel zu Markdown	Nur zwischengespeicherte Werte; führende Nullen als Text bewahrt
CSV / TSV → Markdown	CSV zu Markdown	Volles RFC-4180: maskierte Felder, eingebettete Kommas, mehrzeilige Zellen
Markdown → Excel / CSV	Markdown-Tabelle zu Excel	Jede Tabelle wird erkannt; Werte als Text geschrieben, nie umgedeutet
Markdown → JSON	Markdown zu JSON	Kopfzeile wird zu Schlüsseln; Typinferenz mit Abschalter
Eine bauen oder neu formatieren	Tabellengenerator	Zellen oder eine bestehende Tabelle einfügen; Ausrichtung und Escaping normalisiert

Alle fünf laufen in Ihrem Browser ohne Upload — und die Formatunterstützungsmatrix dokumentiert, wie jeder Exporteur Tabellenausrichtung, mehrzeilige Zellen und Escaping behandelt.

Tabellen in GitHub, Reddit und Slack

GitHub rendert volles GFM inklusive Ausrichtung und Inline-Formatierung; halten Sie eine Leerzeile zwischen Tabelle und umgebendem Text.
Reddit unterstützt Pipe-Tabellen in den meisten Kontexten (Ausrichtung inklusive), aber nicht innerhalb von Zitaten.
Slack und Discord rendern keine Tabellen — die Pipes erscheinen wörtlich. Für den Chat rendert das Markdown → Bild-Tool die Tabelle als teilbares Bild.

Häufig gestellte Fragen

Wie schreibe ich einen Zeilenumbruch in eine Markdown-Tabellenzelle?

Verwenden Sie ein HTML-<br>-Tag — Markdowns Zwei-Leerzeichen-Regel für Umbrüche funktioniert in einer Tabellenzeile nicht, weil die Zeile eine einzige lange Zeile ist. Die meisten Renderer, GitHub eingeschlossen, akzeptieren <br> in Tabellenzellen.

Unterstützt Markdown verbundene Zellen?

Nein. GFM-Tabellen haben kein colspan oder rowspan. Um verbundene Daten darzustellen, wiederholen Sie den Wert in jeder Zeile oder strukturieren die Tabelle um; manche Präprozessoren erzeugen wiederholte Zellen aus übergehenden Quelldaten.

Warum rendert meine Markdown-Tabelle nicht?

Die drei üblichen Ursachen: Eine Leerzeile fehlt zwischen Tabelle und vorhergehendem Absatz, die Ausrichtungszeile ist fehlerhaft (sie darf nur Pipes, Bindestriche und Doppelpunkte enthalten, auf eigener Zeile), oder nicht escapete Pipes in Zellen spalten Zeilen vorzeitig.

Wie viele Spalten darf eine Markdown-Tabelle haben?

Das Format setzt kein Limit — die Lesbarkeit tut es. Jenseits von etwa sieben Spalten lassen sich Zeilen in der Quellform schwer erfassen und laufen oft über die gerenderte Seitenbreite hinaus; erwägen Sie, die Tabelle zu transponieren oder aufzuteilen.

Erscheinen Markdown-Tabellen korrekt in Word und Excel?

Nicht durch Einfügen — Word und Excel haben keinen Markdown-Parser. Konvertieren Sie zuerst: Ein struktur-bewusster Konverter macht aus GFM-Tabellen editierbare Word-Tabellen oder echte .xlsx-Blätter und bewahrt Kopfzeilen, Ausrichtung und führende Nullen.