Markdown-Tabellengenerator

Markdown-Tabellen sind der Standardweg, um Zeilen und Spalten in eine README, eine Pull-Request-Beschreibung oder eine Dokumentationsseite zu bringen. Der Haken: Die Syntax ist unforgiving — jede Zeile muss zur Kopfzeile passen, und ein einzelnes verirrtes Pipe kann den ganzen Block stillschweigend zerstören. Dieser Generator gibt Ihnen ein Raster im Tabellenkalkulations-Stil zum Eintippen und schreibt beim Tippen korrekte Pipe-Syntax.

Die drei Teile einer Pipe-Tabelle

Jede Pipe-Tabelle besteht aus drei gestapelten Blöcken:

• Eine Kopfzeile, zum Beispiel | Method | Safe | Idempotent |
• Eine Trennzeile, die erforderlich ist und die zweite Zeile sein muss: |:---|:---:|---:|
• Null oder mehr Datenzeilen: | GET | Yes | Yes |

Die Trennzeile sagt dem Parser „das ist eine Tabelle“ statt eines Textabsatzes. Jede Zelle in dieser Zeile steuert die Ausrichtung ihrer Spalte:

Marker	Ausrichtung	Typische Verwendung
:---	links	Text, Namen, Beschriftungen
:---:	zentriert	kurze Statuswerte, Wahrheitswerte
---:	rechts	Zahlen, Währung, Anzahlen

Manche Renderer akzeptieren ein blankes --- ohne Doppelpunkt und behandeln es als linksbündig. Der Generator verlässt sich nie darauf: Er schreibt für links immer ein ausdrückliches :---.

Das Raster verwenden

1. Die Größe festlegen. Geben Sie Zeilen (1–20) und Spalten (1–10) ein und klicken Sie dann auf Raster aktualisieren. Vergrößern behält den bereits getippten Inhalt; Verkleinern verwirft die Zeilen und Spalten jenseits der neuen Größe.
2. In die Zellen tippen. Das Raster öffnet mit einer kleinen Beispieltabelle (Name, Age, City), die Sie überschreiben können.
3. Ausrichtung je Spalte wählen. Das Dropdown über jeder Spaltenkopfzeile setzt links, zentriert oder rechts nur für diese Spalte, sodass eine Tabelle alle drei mischen kann.
4. Das Ergebnis kopieren. Der Markdown-Quelltext aktualisiert sich beim Tippen, mit einer gerenderten Vorschau darunter. Pipe-Zeichen innerhalb einer Zelle werden automatisch als \| maskiert.

Ein Praxisbeispiel: eine HTTP-Methoden-Tabelle

Angenommen, Sie wollen drei Spalten — Method, Safe, Idempotent —, wobei die erste linksbündig, die zweite zentriert und die dritte rechtsbündig ist. Füllen Sie das Raster so:

Method	Safe	Idempotent
GET	Yes	Yes
POST	No	No
PUT	No	Yes
DELETE	No	Yes

Der erzeugte Quelltext lautet:

| Method | Safe | Idempotent |
|:---|:---:|---:|
| GET | Yes | Yes |
| POST | No | No |
| PUT | No | Yes |
| DELETE | No | Yes |

Zwei Details sind beachtenswert. Die Trennzeile wird ohne Leerzeichen um die Pipes geschrieben (|:---|:---:|---:|), während Kopf- und Datenzeilen Leerzeichen nutzen (| GET | Yes | Yes |); beide sind gültig, und der Parser behandelt sie identisch. Und weil Sie echte Werte in das Raster getippt haben, stimmt die Spaltenzahl in jeder Zeile garantiert überein.

Häufige Fehler, die das Rendering zerstören

• Eine Zeile mit falscher Zellenzahl. Die meisten Parser lassen die ganze Tabelle fallen, statt zu raten, welche Spalte fehlt.
• Die Trennzeile weglassen oder eine Leerzeile zwischen Kopfzeile und Trennzeile setzen. Der Block fällt auf gewöhnlichen Text zurück.
• Ein unmaskiertes | in einer Zelle verwenden, etwa um „oder“ zu bedeuten. Es erzeugt eine zusätzliche Spalte und verschiebt alles danach.
• Einen Zeilenumbruch in eine Zelle setzen. Pipe-Tabellen sind eine Zeile pro Zeile; ein Umbruch beendet die Zeile vorzeitig.
• Erwarten, dass andere Markdown-Zeichen neutralisiert werden. Das Werkzeug maskiert nur Pipes. Eine Zelle, die mit -, # oder > beginnt, kann vom Renderer als Formatierung interpretiert werden; vermeiden Sie solche Anfänge, wenn Sie wörtlichen Text wollen.

Was Markdown-Tabellen nicht können

Pipe-Tabellen haben keine verbundenen Zellen, keine mehrzeiligen Zellen, keine Beschriftungen und keine Fußnoten, und sie können keine Liste oder einen eingezäunten Codeblock verschachteln. Spaltenbreiten wählt der Renderer, sie werden nicht in der Quelle gespeichert, sodass das Auffüllen von Zellen mit Leerzeichen keinen Einfluss auf das endgültige Layout hat. Wenn Sie eines dieser Merkmale brauchen, bauen Sie stattdessen eine HTML-<table>.

Warum manuelles Bearbeiten schiefgeht

Sobald eine Tabelle das Raster verlässt, schleichen sich beim Bearbeiten von Hand Fehler ein. Betrachten Sie das Hinzufügen einer Zeile zu einer dreispaltigen Tabelle:

| Method | Safe | Idempotent |
|:---|:---:|---:|
| GET | Yes | Yes |
| POST | No | No |

| PATCH | No | No | hinzuzufügen ist leicht, aber eine Zeile mit nur zwei Zellen — | PATCH | No | — lässt die Tabelle in den meisten Renderern stillschweigend verschwinden. Dasselbe passiert mit einem unmaskierten Pipe als Text: | GET | yes\|no | Yes | überlebt nur wegen des Backslashs.

Eine zweite Falle ist die Trennzeile. Oft kopieren Leute die Kopfzeile und ersetzen die Wörter durch Striche, was eine Zeile mit verirrten Leerzeichen oder falscher Spaltenzahl erzeugt. Ein nachsichtiger Parser rendert sie vielleicht noch, ein strengerer scheitert. Im Zweifel fügen Sie den Quelltext wieder ins Raster ein, passen ihn an und kopieren ihn erneut, statt Pipes von Hand zu bearbeiten.

Wo die Ausgabe gerendert wird

Fügen Sie das Ergebnis in GitHub-READMEs, Issues, Pull Requests und Wikis ein; in GitLab und Bitbucket; in Stack Overflow und Reddit; in Discord und Slack; in Notion und Obsidian; in Jupyter-Notebooks; und in Static-Site-Generatoren wie Hugo, Jekyll und Astro. Jeder davon verarbeitet die Ausrichtungsmarker und ignoriert die Füll-Leerzeichen, sodass derselbe Quelltext überall dort sauber rendert, wo die Erweiterung unterstützt wird. Alles läuft lokal im Browser — Ihr Tabellentext wird nie an einen Server gesendet.

Verwandte Tools

• Markdown-Editor
• HTML-Tabellengenerator
• CSV-Viewer