Markdown-Tabelle erstellen: Syntax, Ausrichtung und Beispiele

Die Grundsyntax

Markdown-Tabellen folgen einem festen Muster. Jede Spalte wird durch ein Pipe-Zeichen getrennt, das auf der deutschen Tastatur mit AltGr und der Taste links neben Y liegt. Direkt unter der Kopfzeile steht eine Pflichtzeile aus Bindestrichen, die Kopf und Daten voneinander abgrenzt. Erst diese Trennzeile macht aus mehreren Textzeilen überhaupt eine Tabelle.

| Spalte A | Spalte B | Spalte C |
| -------- | -------- | -------- |
| Wert 1   | Wert 2   | Wert 3   |
| Wert 4   | Wert 5   | Wert 6   |

Das Ergebnis ist eine dreispaltige Tabelle mit zwei Datenzeilen. Die äußeren Pipe-Zeichen am Zeilenanfang und Zeilenende sind übrigens optional, sie verbessern aber die Lesbarkeit im Quelltext. Mindestens drei Bindestriche pro Spalte sind eine gute Gewohnheit, technisch reicht oft schon einer.

Spalten ausrichten: links, mittig, rechts

Die Ausrichtung steuern Sie ausschließlich über die Trennzeile, indem Sie Doppelpunkte an die Bindestriche setzen. Die Regel ist leicht zu merken: Der Doppelpunkt zeigt, wohin der Text rückt.

• :--- richtet die Spalte linksbündig aus.
• :---: zentriert die Spalte.
• ---: richtet die Spalte rechtsbündig aus, ideal für Zahlen und Beträge.
• :--: ist die kurze Schreibweise für zentriert.

In der Praxis sieht eine Tabelle mit allen drei Varianten so aus:

| Links     | Mittig | Rechts |
| :-------- | :----: | -----: |
| Text      | Text   | 1,50   |
| Mehr Text | OK     | 12,00  |

Beträge und Mengen wirken rechtsbündig deutlich aufgeräumter, weil die Kommastellen untereinander stehen. Für Textspalten ist linksbündig fast immer die beste Wahl.

Häufige Fehler

Die meisten kaputten Tabellen scheitern an wenigen, immer gleichen Ursachen. Diese Übersicht hilft beim schnellen Eingrenzen:

So sieht eine Tabelle aus, der genau die wichtige Trennzeile fehlt. Sie wird in keiner Umgebung als Raster erscheinen:

| Name | Rolle |
| Anja | Leitung |

Mit einer einzigen ergänzten Bindestrich-Zeile zwischen Kopf und Daten funktioniert sie sofort.

Tabelle in HTML umwandeln

Soll Ihre Markdown-Tabelle in eine Webseite oder ein CMS, das kein Markdown versteht, wandeln Sie sie in HTML um. Fügen Sie die Tabelle in den Markdown-zu-HTML-Konverter ein und Sie erhalten ein vollständiges <table>-Element mit <thead> und <tbody>. Das passiert komplett lokal im Browser, ohne Upload und kostenlos.

Tipp: HTML-Tabelle automatisch holen

Sie müssen eine Tabelle nicht immer von Hand abtippen. Liegt sie bereits als HTML vor, etwa aus einer Webseite kopiert, dann nutzen Sie die Gegenrichtung und lassen sie automatisch in Markdown umwandeln. Wie das im Detail läuft und wo die Grenzen liegen, steht im Ratgeber HTML-Tabelle in Markdown umwandeln.

Übrigens kommt Markdown auch mit sehr knappem Quelltext klar. Ohne Leerzeichen und ohne äußere Pipes ist diese Form völlig gültig:

Name|Rolle
---|---
Anja|Leitung

Grenzen von Markdown-Tabellen

Markdown-Tabellen sind für überschaubare Datenraster gemacht. Verbundene Zellen über mehrere Spalten oder Zeilen, mehrere Kopfzeilen oder verschachtelte Tabellen gehören nicht dazu. Auch Zeilenumbrüche innerhalb einer Zelle sind nur über den Umweg <br> möglich. Wird eine Tabelle so komplex, ist eine reine HTML-Tabelle die ehrlichere Lösung, die Sie in GitHub Flavored Markdown einfach als rohen HTML-Block einbetten dürfen.

Häufige Fragen