Markdown-Tabellen: die komplette Anleitung

Tabellen gehören zu den nützlichsten Teilen von Markdown – und zu den fehleranfälligsten. Diese Anleitung reicht von der Grundform bis zu Ausrichtung, Zeilenumbrüchen, Sonderzeichen und der Umwandlung aus Tabellenkalkulationen. Zum Ausprobieren fügst du die Beispiele in den Online Markdown-Editor ein und siehst sofort das Ergebnis.

Grundsyntax

Eine Tabelle besteht aus Kopfzeile, Trennzeile und Datenzeilen. Spalten trennst du mit |.

| Name | Team | Durchwahl |
| --- | --- | --- |
| Anna | Vertrieb | 101 |
| Ben | Design | 205 |

Ergebnis:

Name Team Durchwahl
Anna Vertrieb 101
Ben Design 205

Wichtig:

  • Die Trennzeile mit --- ist Pflicht, mindestens drei Striche pro Spalte.
  • Die äußeren | sind optional, machen die Tabelle aber lesbarer.
  • Jede Zeile sollte so viele Spalten haben wie die Kopfzeile.
  • Vor und nach der Tabelle eine Leerzeile lassen.

Spaltenausrichtung

Doppelpunkte : in der Trennzeile steuern die Ausrichtung:

| Links | Mitte | Rechts |
| :--- | :---: | ---: |
| Äpfel | 10 | 3,00 € |
| Bananen | 5 | 1,50 € |
Links Mitte Rechts
Äpfel 10 3,00 €
Bananen 5 1,50 €

Zahlen und Preise rechtsbündig ausrichten, dann lassen sie sich leicht vergleichen.

Inline-Markdown funktioniert auch in Zellen:

| Befehl | Beschreibung |
| --- | --- |
| `npm install` | Pakete installieren, siehe [Doku](https://docs.npmjs.com/) |
| **Pflicht** | Dieses Feld muss ausgefüllt werden |

Ein Pipe-Zeichen in einer Zelle anzeigen

| gilt als Spaltentrenner, deshalb mit Backslash maskieren:

| Operator | Bedeutung |
| --- | --- |
| `a \| b` | Bitweises ODER |

Zeilenumbrüche in Zellen

Standard-Markdown-Tabellen unterstützen keine Zeilenumbrüche in Zellen; jede Zeile muss in einer Zeile stehen. Übliche Lösungen:

  • GitHub akzeptiert <br>, etwa erste Zeile<br>zweite Zeile.
  • Moread führt aus Sicherheitsgründen keine HTML-Tags aus, <br> erscheint als Text. Teile den Inhalt auf mehrere Zeilen auf oder nutze eine Liste.

Verbundene Zellen

Standard-Markdown-Tabellen können keine Zellen verbinden. Alternativen:

  1. Den Wert wiederholen, damit die Tabelle regelmäßig bleibt.
  2. In zwei kleinere Tabellen aufteilen.
  3. Bei komplexen Inhalten sind Listen oder Zwischenüberschriften oft klarer.

Aus Excel oder Google Tabellen umwandeln

Kopierte Zellen werden zu tabulatorgetrenntem Text. Zum Umwandeln:

  • Tabulatoren im Texteditor durch | ersetzen, | an Zeilenanfang und -ende setzen und die Trennzeile einfügen.
  • Oder einen „Excel to Markdown“-Konverter nutzen.

Danach im Online-Editor prüfen, ob die Spalten stimmen.

Breite Tabellen

Tabellen mit vielen Spalten passen auf dem Handy oft nicht. Moread lässt Tabellen seitlich scrollen, damit das Layout erhalten bleibt. Beim Schreiben hilft außerdem:

  • Unwichtige Spalten weglassen.
  • In Zellen kurze Stichworte nutzen und Details unter der Tabelle erklären.

Vorlage zum Kopieren

| Posten | Menge | Betrag |
| :--- | ---: | ---: |
| Posten eins | 1 | 100 |
| Posten zwei | 2 | 250 |
| **Summe** | **3** | **350** |

Mehr Syntax in der Markdown-Anleitung; für Berichte siehe Markdown in PDF umwandeln.