Markdown Tabellen Generator
GFM Tabellen (GitHub Flavored Markdown) verwenden Pipe-Zeichen zur Spaltentrennung, eine Trennlinie mit Bindestrichen zur Definition der Kopfzeile und optionale Doppelpunkte in der Trennlinie zur Steuerung der Ausrichtung. Das Format wird von GitHub, GitLab, vielen statischen Site-Generatoren und den meisten Markdown Editoren unterstützt.
GFM Tabellensyntax
Die minimale gültige Tabelle erfordert eine Kopfzeile, eine Trennlinie und mindestens eine Datenzeile:
| Name | Rolle |
|------|------|
| Alice | Entwicklerin |
| Bob | Designer |Die Trennlinie muss mindestens drei Bindestriche (---) pro Zelle enthalten. Mehr Bindestriche spielen keine Rolle; sie ändern das Verhalten nicht, sondern beeinflussen nur die Lesbarkeit im Quellcode.
Spaltenausrichtung
Die Ausrichtung wird mit Doppelpunkten in der Trennlinie definiert:
| Links | Zentriert | Rechts |
|:-----|:--------:|-------:|
| text | text | text || Syntax | Ausrichtung |
|---|---|
:--- | Linksbündig (Standard) |
:---: | Zentriert |
---: | Rechtsbündig |
Rechtsbündig ist am nützlichsten für numerische Spalten, bei denen die Ziffern ausgerichtet werden sollen.
Pipe Formatierung im Quellcode
Die Pipes am Anfang und Ende jeder Zeile sind in der Spezifikation optional, aber die meisten Formatierer und Linter verlangen sie. Du musst die Zellen nicht auffüllen, um die Pipes visuell auszurichten. Diese beiden Tabellen werden gleich gerendert:
| Spalte 1 | Spalte 2 | Spalte 3 |
|----------|----------|----------|
| Kurz | Ein viel längerer Zellenwert | x |
|Spalte 1|Spalte 2|Spalte 3|
|---|---|---|
|Kurz|Ein viel längerer Zellenwert|x|Prettier und ähnliche Formatierer füllen die kurze Version beim Speichern auf die ausgerichtete Version auf.
Was Markdown Tabellen Nicht Können
Keine zusammengeführten Zellen
Jede Zeile muss genau die gleiche Anzahl von Zellen haben. Es gibt kein Äquivalent zu colspan oder rowspan. Wenn eine Zelle sich über mehrere Spalten erstrecken muss, verwende HTML Tabellen innerhalb deines Markdown.
Keine verschachtelten Tabellen
Du kannst keine Tabelle innerhalb einer Tabellenzelle platzieren. Der Pipe-basierte Parser hat keine Vorstellung von verschachtelten Strukturen.
Keine Blockelemente in Zellen
Du kannst keine Absätze, Listen oder Codeblöcke innerhalb einer einzelnen Zelle haben. Macht man das, wird die Tabelle beschädigt. Für mehrzeiligen Inhalt innerhalb eines Rasters sind HTML Tabellen der richtige Weg.
Brauchst du Hilfe bei Markdown im Allgemeinen? Der Markdown Editor bietet eine Live-Vorschau für deine gesamte Markdown Datei.