Markdown-Tabellen: So schreibst und liest du sie

Eine Markdown-Tabelle ist reiner Text, der zu einem Raster wird. Du tippst Wörter, senkrechte Striche | und Bindestriche -. Ein Markdown-Leser zeigt Zeilen und Spalten.

Tabellen gibt es überall in Markdown-Dateien: Preislisten, Pläne, Vergleiche, Testergebnisse. KI-Chats und Coding-Agenten schreiben sie ständig.

Die einfache Tabelle

| Obst   | Farbe  | Preis |
|--------|--------|-------|
| Apfel  | Rot    | 1.20  |
| Banane | Gelb   | 0.50  |

So wird sie angezeigt:

ObstFarbePreis
ApfelRot1.20
BananeGelb0.50

Drei Arten von Zeilen:

  1. Kopfzeile: die Spaltennamen.
  2. Strichzeile: trennt die Kopfzeile vom Rest. Sie ist erforderlich. Ohne sie gibt es keine Tabelle.
  3. Datenzeilen: eine Zeile pro Eintrag.

Senkrechte Striche | trennen die Zellen. Die Striche am Anfang und Ende jeder Zeile sind optional, machen die Tabelle aber leichter lesbar.

Die Spalten müssen in deinem Text nicht untereinander ausgerichtet sein. Das funktioniert auch:

| Obst | Farbe | Preis |
|---|---|---|
| Apfel | Rot | 1.20 |

Lass vor und nach der Tabelle eine leere Zeile. Die Tabelle endet an der ersten leeren Zeile.

Spalten ausrichten

Füge der Strichzeile Doppelpunkte : hinzu:

| Links | Mitte | Rechts |
|:------|:-----:|-------:|
| a     | b     | 1.20   |
| aa    | bb    | 10.50  |
LinksMitteRechts
ab1.20
aabb10.50

Formatierung in einer Zelle

Zellen können Fett, Kursiv, Code und Links enthalten:

| Task      | Status   | Link                         |
|-----------|----------|------------------------------|
| Write     | **Done** | [Notes](https://example.com) |
| `npm test`| *Running*|                              |

Um einen senkrechten Strich in eine Zelle zu setzen, schreibe ihn als \|. Sonst beginnt er eine neue Zelle. Das gilt auch innerhalb von Code.

Was Tabellen nicht können

Breite Tabellen

Eine Tabelle mit vielen Spalten wird breit, besonders auf einem Smartphone. Einige Tipps:

Schnelle Wege zu einer Tabelle

Markdown-Tabellen lesen

In einem einfachen Texteditor bleibt eine Tabelle aus senkrechten Strichen und Bindestrichen. Das ist bei kleinen Tabellen lesbar, bei großen aber schwierig. Ein Markdown-Leser zeigt das echte Raster.

PilcrowMD zeigt Markdown-Tabellen auf Android und Mac. Zellen können Fett, Kursiv, Links und Formeln darstellen. Auf Android lässt sich eine breite Tabelle seitlich scrollen, damit die Spalten nicht gequetscht werden.

Häufige Fragen

Ist eine Markdown-Tabelle überall gleich? Meistens. Tabellen sind Teil von GitHub Flavored Markdown, dem die meisten Apps folgen. Einige sehr einfache Markdown-Apps zeigen Tabellen gar nicht an.

Kann ich einen Zeilenumbruch in eine Zelle setzen? Nicht in Standard-Markdown. Einige Apps akzeptieren das HTML-Tag <br>, aber nicht alle.

Muss ich die senkrechten Striche untereinander ausrichten? Nein. Es macht den Text nur leichter lesbar.

Auch für Mac: PilcrowMD für Mac (Beta)