Markdown-Tabellen-Generator

Was eine Markdown-Tabelle wirklich ist

Markdown-Tabellen sind nicht Teil der ursprünglichen Markdown-Spezifikation; sie stammen aus GitHub Flavored Markdown, dem von GitHub populär gemachten Dialekt, der heute fast überall unterstützt wird, wo Entwickler schreiben. Die Syntax ist bewusst reiner Text: Spalten werden durch den senkrechten Strich getrennt, die Überschriftenzeile sitzt oben, und eine zweite Zeile aus Bindestrichen trennt die Überschrift vom Inhalt. Weil es bloß Text ist, bleibt eine Markdown-Tabelle in ihrer Rohform lesbar und übersteht Kopieren und Einfügen, Versionsverwaltungs-Diffs und E-Mail auf eine Weise, wie es eine HTML-Tabelle nie könnte.

Dieses Tool nimmt dir das mühsame Ausrichten dieser Striche ab. Du fügst gewöhnliche Zeilen ein, es ermittelt die Spalten und schreibt eine korrekt aufgebaute Tabelle mit der Überschrift, der Trennzeile und jeder Zelle an ihrem Platz.

Die Anatomie der Syntax

Eine minimale Tabelle sieht aus wie drei Zeilen. Die erste Zeile listet die Überschriften, durch senkrechte Striche getrennt, zum Beispiel Name, dann ein Strich, dann Rolle. Die zweite Zeile ist das Trennzeichen: eine Gruppe von Bindestrichen pro Spalte, etwa drei Bindestriche, ein Strich, drei Bindestriche. Jede Zeile danach ist eine Datenzeile mit demselben Strichmuster. Die äußeren Striche am Anfang und Ende jeder Zeile sind in GFM optional, doch sie einzuschließen macht den Rohtext leichter lesbar, und genau das erzeugt dieser Generator.

Die Trennzeile erfüllt eine Doppelfunktion: Sie signalisiert sowohl, dass die Zeile darüber eine Überschrift ist, als auch, durch die Platzierung von Doppelpunkten, wie jede Spalte ausgerichtet ist. Deshalb braucht eine Markdown-Tabelle stets mindestens eine Überschriften- und eine Trennzeile, um überhaupt dargestellt zu werden.

Die Spaltenausrichtung festlegen

Die Ausrichtung steckt vollständig in den Bindestrichen der Trennzeile, gesteuert durch Doppelpunkte. Ein Doppelpunkt links der Bindestriche richtet die Spalte links aus, ein Doppelpunkt auf beiden Seiten zentriert sie, und ein Doppelpunkt rechts richtet sie rechts aus. Eine zentrierte Spalte wird also als Doppelpunkt, ein paar Bindestriche, dann ein Doppelpunkt geschrieben, während eine rechtsbündige Spalte mit einem Doppelpunkt endet. Rechtsbündig ist die übliche Wahl für Zahlenspalten, damit sich die Ziffern nach ihrem Stellenwert aneinanderreihen.

Wählst du in diesem Tool Links, Mitte oder Rechts, schreibt es diese Doppelpunktmarkierungen für dich über die gesamte Tabelle, was bedeutet, dass die Ausrichtung auf GitHub, in Dokumentationsgeneratoren und in jeder anderen GFM-Anzeige identisch dargestellt wird, statt von den Einstellungen des Lesers abzuhängen.

Ein durchgerechnetes Beispiel

Füge drei kommagetrennte Zeilen ein, oben Name, Rolle, Stadt, gefolgt von Ada Lovelace, Engineer, London und Grace Hopper, Admiral, New York. Mit ausgewählter zentrierter Ausrichtung gibt das Tool eine Überschriftenzeile mit den drei Titeln aus, eine Trennzeile, in der die Bindestriche jeder Spalte in Doppelpunkte gefasst sind, sowie zwei Datenzeilen. In eine README auf GitHub eingefügt, wird sie als saubere dreispaltige Tabelle mit zentrierten Werten dargestellt, ganz ohne manuelles Strichezählen.

Striche maskieren und andere Stolperfallen

Der senkrechte Strich ist das Spaltentrennzeichen, daher würde ein wörtlicher Strich innerhalb einer Zelle diese Zelle normalerweise in zwei teilen und die Tabelle zerstören. Dieses Tool maskiert jeden Strich in deinen Daten automatisch, indem es ihn als Rückwärtsschrägstrich gefolgt von einem Strich schreibt, sodass ein Wert wie ein logischer Ausdruck mit einem ODER-Symbol in einer Zelle bleibt und wie beabsichtigt dargestellt wird.

Zwei weitere Dinge solltest du wissen. Markdown-Tabellen können innerhalb einer Zelle keine harten Zeilenumbrüche über die Eingabetaste enthalten; brauchst du einen Umbruch innerhalb einer Zelle, würdest du ein ausdrückliches br-Tag einfügen, da GFM Inline-HTML erlaubt. Und jede Zeile sollte dieselbe Spaltenzahl wie die Überschrift haben. Überzählige Zellen in einer Zeile werden von den meisten Renderern ignoriert und fehlende Zellen als leer dargestellt, halte deine Zeilen also rechteckig, um vorhersehbare Ergebnisse zu erhalten.

Trennzeichen und Werte in Anführungszeichen

Echte Daten kommen nicht immer kommagetrennt an. Lässt du das Trennzeichen auf Auto, kann das Tool erkennen, ob deine Zeilen Kommas, Tabs oder senkrechte Striche verwenden, was bedeutet, dass sich ein direkt aus einer Tabelle kopierter Block (tabgetrennt) und ein CSV-Export (kommagetrennt) beide ohne Konfiguration umwandeln lassen. Du kannst zudem ein bestimmtes Trennzeichen erzwingen, wenn die automatische Erkennung falsch raten würde, etwa bei Daten, die berechtigterweise viele Kommas enthalten.

Auch in Anführungszeichen gesetzte CSV-Werte werden korrekt behandelt. Ein Komma innerhalb doppelter Anführungszeichen wird als Teil des Werts behandelt, sodass ein Feld wie ein in Anführungszeichen gesetzter Eintrag mit nachgestelltem Nachnamen in einer einzigen Zelle bleibt, statt in zwei Spalten zu zerbrechen. Das ist wichtig, weil Tabellenexporte routinemäßig jeden Wert in Anführungszeichen setzen, der selbst das Trennzeichen enthält.

Wo Markdown-Tabellen funktionieren und wo nicht

Markdown-Tabellen glänzen in Entwickler- und Schreibkontexten: READMEs, Issues und Pull Requests auf GitHub und GitLab; Generatoren für statische Seiten und Dokumentation; viele Wikis und Notiz-Apps; Chat-Tools wie Slack und Discord in ihren Markdown-fähigen Feldern; und Reddit-Kommentare. Überall, wo GFM unterstützt wird, funktioniert eine eingefügte Tabelle einfach und bleibt in der Quellform gut lesbar.

Universell sind sie jedoch nicht. Reines Markdown ohne die GFM-Erweiterung versteht keine Tabellen, und einige schlanke Renderer ignorieren sie, in welchem Fall die rohen Striche durchscheinen. Markdown-Tabellen fehlt es zudem an feiner Gestaltungskontrolle, verbundenen Zellen und verschachtelter Struktur. Wenn du präzise Formatierung, Spaltenverbünde oder reichhaltige Gestaltung brauchst, ist eine HTML-Tabelle die bessere Wahl; wenn du eine saubere, versionierbare, menschenlesbare Tabelle willst, gewinnt Markdown.