Markdown-Tabellen-Generator

Wandle CSV oder TSV in eine ausgerichtete GitHub-Flavored-Markdown-Tabelle um: RFC-4180-Parser, automatische Trennzeichenerkennung, Pipe-Escaping.

Eingabe

Kopiere Tabellendaten aus einer Tabellenkalkulation, einem CSV-Export oder einer Datenbankabfrage in das Eingabefeld – heraus kommt eine fertige Tabelle im GitHub-Flavored-Markdown-Format. Der Parser hält sich an RFC 4180 und versteht deshalb Felder in Anführungszeichen, verdoppelte Anführungszeichen und sogar Zeilenumbrüche innerhalb eines Feldes. Jede Spalte wird auf dieselbe Breite aufgefüllt, damit der Markdown-Quelltext auch ungerendert und im Diff lesbar bleibt. Die Verarbeitung läuft vollständig in deinem Browser.

Was ist ein Markdown-Tabellen-Generator?

Ein Markdown-Tabellen-Generator übersetzt begrenzte Daten – CSV, TSV oder mit Semikolon getrennte Werte – in eine Tabelle im GitHub-Flavored-Markdown-Format. Er erzeugt die Kopfzeile, die Trennzeile mit den Ausrichtungsmarkern und alle Datenzeilen, füllt jede Spalte auf eine einheitliche Breite auf und entschärft die Zeichen, die eine Markdown-Tabelle zerlegen würden. Gedacht ist das für README-Dateien, Pull-Request-Beschreibungen, Dokumentation und Wikis, in denen Tabellen als reiner Text versioniert werden statt als Binärformat.

So funktioniert der Tabellen-Generator

Der eingefügte Text wird mit einem RFC-4180-konformen Parser gelesen, nicht mit einem simplen Split: Ein Feld in Anführungszeichen darf das Trennzeichen, einen Zeilenumbruch oder ein verdoppeltes Anführungszeichen enthalten, das für ein einzelnes literales steht. Bleibt das Trennzeichen auf automatisch, wird die erste Zeile auf Tabulatoren, Semikolons und Kommas geprüft — das häufigste gewinnt. Jede Zelle wird dann für Markdown maskiert: ein freistehender senkrechter Strich wird zu \|, interne Zeilenumbrüche werden zu einem Leerzeichen, denn eine GFM-Tabellenzeile muss in einer Zeile stehen. Zum Schluss wird jede Spalte auf die Breite ihrer längsten Zelle aufgefüllt, damit das rohe Markdown im Diff lesbar bleibt — auf die gerenderte Tabelle hat das Auffüllen keinen Einfluss.

Funktionen

RFC-4180-Parser: Felder in Anführungszeichen, verdoppelte Anführungszeichen ("") und Zeilenumbrüche innerhalb eines Feldes bleiben korrekt erhalten.
Automatische Trennzeichenerkennung anhand der ersten Zeile – Tabulator, Semikolon oder Komma –, die du jederzeit überstimmen kannst.
Pipe-Zeichen werden als \| maskiert und Zeilenumbrüche innerhalb einer Zelle zu einer Zeile geglättet, weil beides die Tabelle sonst zerreißt.
Alle Spalten werden auf gleiche Breite aufgefüllt; die Trennzeile spiegelt die Ausrichtung als ---, :-: oder --: wider.

So benutzt du das Tool

1

Füge deine CSV- oder TSV-Daten in das Eingabefeld ein – eine Textzeile pro Tabellenzeile.

2

Lass das Trennzeichen auf automatischer Erkennung oder wähle Komma, Semikolon bzw. Tabulator selbst aus.

3

Lege fest, ob die erste Zeile die Kopfzeile ist, und stelle die Ausrichtung auf linksbündig, zentriert oder rechtsbündig.

4

Kopiere die erzeugte Markdown-Tabelle und füge sie in dein README, Ticket oder Wiki ein.

Typische Stolperfallen

Werte mit Komma ohne Anführungszeichen: Erst "Kabel, 2 m" bleibt ein Feld – ohne Anführungszeichen entstehen daraus zwei Spalten.
Deutsche Tabellen-Exports nutzen meist Semikolon. Steht das Trennzeichen fest auf Komma, landet die komplette Zeile in einer einzigen Spalte.
Erwarten, dass mehrzeilige Zellen mehrzeilig bleiben: Markdown-Tabellen kennen keine Zeilenumbrüche in Zellen, der Inhalt wird deshalb zu einer Zeile geglättet.

Beispiele

Name,Rolle Ada,Erfinderin → | Name | Rolle | | ---- | ---------- | | Ada | Erfinderin |
Artikel;Preis "Kabel, 2 m";9,99 → | Artikel | Preis | | ---------- | ----- | | Kabel, 2 m | 9,99 |
Regex,Bedeutung a|b,oder → | Regex | Bedeutung | | ----- | --------- | | a\|b | oder |

Siehe auch

  • CSV zu JSON — Du willst dieselben Zeilen als strukturierte Daten statt als Tabelle? Wandle sie in JSON um.
  • Leerzeichen entfernen — Übersehene führende Leerzeichen landen in jeder Zelle — entferne sie vorher.

FAQ

Welche Trennzeichen erkennt das Tool automatisch?

Geprüft wird die erste Zeile, und zwar auf Tabulator, Semikolon und Komma. Passt die Erkennung im Einzelfall nicht, wählst du das Trennzeichen einfach manuell aus – dann wird die automatische Prüfung übersprungen.

Was passiert mit Pipe-Zeichen und Zeilenumbrüchen innerhalb einer Zelle?

Ein rohes Pipe-Zeichen würde eine neue Spalte beginnen, ein Zeilenumbruch eine neue Zeile. Deshalb wird jedes | in der Zelle zu \| maskiert und der Inhalt einer mehrzeiligen Zelle auf eine einzige Zeile geglättet.

Wie stelle ich die Spaltenausrichtung ein?

Die Ausrichtung steckt in der Trennzeile unter der Kopfzeile. Linksbündig erzeugt ---, zentriert :-: und rechtsbündig --:. Die Einstellung gilt für die gesamte Tabelle und wird von Markdown-Renderern wie GitHub ausgewertet.

Versteht der Parser Anführungszeichen wie in echten CSV-Dateien?

Ja, der Parser folgt RFC 4180. Felder in Anführungszeichen dürfen das Trennzeichen und Zeilenumbrüche enthalten, und zwei aufeinanderfolgende Anführungszeichen ("") innerhalb eines solchen Feldes stehen für ein einzelnes Anführungszeichen im Wert.