Markdown-Tabelle-zu-CSV-Konverter
Konvertiert eine Markdown-Tabelle (`| col1 | col2 |`) in CSV oder TSV. Praktisch, um Tabellen aus GitHub Wiki, Notion oder Confluence nach Excel oder in eine Tabellenkalkulation zu übernehmen. Die Umwandlung erfolgt vollständig im Browser; es werden keine Daten an einen Server gesendet.
| Ausgabe-Trennzeichen |
|
|---|---|
| Kopfzeile in die Ausgabe einschließen |
Geben Sie eine Markdown-Tabelle ein, um hier das erzeugte CSV zu sehen.
Wie eine Markdown-Tabellenzeile einer CSV-Zeile entspricht
| Eine Markdown-Zeile | | name | age | city | |
|---|---|
| Resultierende CSV-Zeile | name,age,city |
Die Trennzeile direkt nach der Kopfzeile (`---`, `:---`, `:---:` oder `---:`) wird übersprungen statt als Daten behandelt. Jedes maskierte Pipe-Zeichen (`\|`) innerhalb einer Zelle wird wieder zu einem normalen "|"-Zeichen.
Was die Umwandlung von Markdown-Tabelle zu CSV bedeutet
Tabellen, die in Dokumentationswerkzeugen wie GitHub Wiki, Notion oder Confluence entstehen, lassen sich hervorragend lesen, stoßen aber schnell an Grenzen, sobald Sie Summen bilden, sortieren oder filtern möchten. Genau dafür sind Tabellenkalkulationsprogramme gemacht – nur müssen die Daten dort erst einmal ankommen. Dieses Werkzeug liest die Markdown-Tabellensyntax ein und wandelt sie in CSV oder TSV um, ohne dass Sie Spalten von Hand abtippen müssen. Die Trennzeile direkt unter der Kopfzeile wird dabei automatisch erkannt und beim Export übersprungen, weil sie inhaltlich keine Daten trägt, sondern lediglich der Formatierung dient.
Unterstützt wird die Syntax von GitHub Flavored Markdown: sowohl die klassische Schreibweise mit Pipe-Zeichen am Zeilenanfang und -ende (`| a | b |`) als auch die kompaktere Variante ohne diese äußeren Pipes. Enthält eine Zelle ein Komma oder ein doppeltes Anführungszeichen, wird sie automatisch nach den CSV-Regeln in Anführungszeichen gesetzt, damit beim späteren Einlesen keine Spalten verrutschen. Fehlt die Trennzeile vollständig, erkennt das Werkzeug den Text nicht als Tabelle und liefert entsprechend kein Ergebnis – ein hilfreicher Hinweis darauf, dass im Ausgangstext etwas nicht stimmt.
So wandeln Sie eine Markdown-Tabelle in CSV um
- Markdown-Tabelle einfügen Kopieren Sie den Tabellenabschnitt aus Ihrem Dokument und fügen Sie ihn ein. Lassen Sie die Trennzeile dabei unbedingt mit im Text.
- Ausgabeformat wählen Entscheiden Sie sich für kommagetrenntes CSV oder tabulatorgetrenntes TSV. Wer direkt in eine Tabellenkalkulation einfügt, ist mit TSV meist auf der sicheren Seite, da Kommas in Zellwerten keine Spalten verschieben.
- Umgang mit der Kopfzeile festlegen Möchten Sie die Spaltentitel getrennt verwalten, deaktivieren Sie "Kopfzeile in die Ausgabe einschließen", sodass nur die reinen Datenzeilen ausgegeben werden.
- Ergebnis kopieren und weiterverwenden Kopieren Sie das Ergebnis direkt in Ihre Tabellenkalkulation oder speichern Sie es als CSV-Datei zum späteren Import.
Tipps für die Nutzung
- Die Trennzeile direkt nach der Kopfzeile wird automatisch erkannt und übersprungen, sodass `---`, `:---` (links), `:---:` (zentriert) und `---:` (rechts) unabhängig von der Ausrichtung problemlos konvertiert werden.
- Wird "Kopfzeile in die Ausgabe einschließen" deaktiviert, entsteht ein CSV, das nur die Datenzeilen ohne Kopfzeile enthält – praktisch, wenn Sie die Kopfzeile separat verwalten möchten.
- Enthält ein Zellenwert ein Komma oder ein doppeltes Anführungszeichen, wird er gemäß den CSV-Regeln automatisch in doppelte Anführungszeichen eingeschlossen, wobei jedes interne `"` als `""` maskiert wird.
- Kombinieren Sie dies mit dem Konverter von CSV zu Markdown-Tabelle, um beliebig oft zwischen CSV und Markdown-Tabellen zu konvertieren.
Einsatzmöglichkeiten für die Umwandlung von Markdown zu CSV
Dokumentationstabellen auswerten
Listen aus GitHub Wiki oder Notion lassen sich in eine Tabellenkalkulation übertragen, um dort zu sortieren, zu filtern oder Summen zu bilden.
README-Listen als Daten weiterverarbeiten
Wandeln Sie Kompatibilitätstabellen oder Konfigurationslisten in CSV um, damit ein Skript sie einlesen und für Prüfungen oder automatische Generierung nutzen kann.
Aufgaben aus Besprechungsprotokollen herauslösen
Eine als Markdown-Tabelle geführte Aufgabenliste lässt sich in ein Format bringen, das sich direkt in ein Projektmanagement-Tool importieren lässt.
Zwischen den Formaten hin- und herwechseln
In Kombination mit dem Schwesterwerkzeug für die Umwandlung von CSV zu Markdown-Tabelle können Sie beliebig oft in beide Richtungen konvertieren, egal mit welchem Format Sie starten.
Begriffe rund um Markdown und CSV
- Tabellensyntax
- Die Markdown-Schreibweise, bei der durch Pipe-Zeichen getrennte Zellen aneinandergereiht eine Tabelle ergeben. Der Unterschied zu CSV liegt darin, dass sie eine Kopfzeile und eine eigene Trennzeile besitzt.
- Trennzeile
- Die Zeile aus Bindestrichen direkt unter der Kopfzeile. Optisch erscheint sie als Trennlinie, ist aber keine Dateneinheit und wird beim Umwandeln übersprungen.
- GFM
- Abkürzung für GitHub Flavored Markdown. Dieser Standard erlaubt neben der klassischen Notation auch Tabellen ohne führende oder abschließende Pipe-Zeichen.
- TSV
- Ein Format, bei dem Werte durch einen Tabulator statt durch ein Komma getrennt werden. Es eignet sich für Daten mit Kommas im Inhalt sowie zum direkten Einfügen in eine Tabellenkalkulation.
- Maskierung (Quoting)
- Das Einschließen eines Zellwerts in doppelte Anführungszeichen nach den CSV-Regeln. Erforderlich, sobald der Wert selbst ein Komma oder ein Anführungszeichen enthält.
Häufig gestellte Fragen
Übrigens – was eine Markdown-Tabelle wirklich von einer CSV unterscheidet
CSV und Markdown-Tabellen sind beides textbasierte Wege, tabellarische Daten darzustellen, dienen aber unterschiedlichen Zwecken. CSV ist ein maschinenlesbares Format, das dafür gedacht ist, von Programmen wie Tabellenkalkulationen und Datenbanken gelesen und geschrieben zu werden, während eine Markdown-Tabelle eine dokumentationsorientierte Notation ist, die Wert darauf legt, dass ein Mensch beim Blick auf den Quelltext trotzdem ungefähr erkennen kann, wie die Tabelle aussieht.
Deshalb besitzt eine Markdown-Tabelle Konzepte, die CSV nicht kennt: eine Kopfzeile und eine Trennzeile (`---`). Optisch wird diese Trennzeile als Trennlinie dargestellt, im Quelltext ist sie jedoch nichts weiter als eine Folge von Bindestrichen – eine Markdown-spezifische Notation, die einzig dazu dient, dem Parser mitzuteilen: "Alles darüber ist die Kopfzeile, alles darunter sind Daten."
Der Wunsch, eine in einem Dokumentationstool wie GitHub Wiki, Notion oder Confluence erstellte Tabelle in eine Tabellenkalkulation zu überführen, kommt beim Aufräumen von Team-Besprechungsprotokollen oder einer README häufig vor. Mit diesem Tool neben seinem Gegenstück – von CSV zu Markdown-Tabelle – lässt sich unabhängig vom Ausgangsformat problemlos in beide Richtungen konvertieren.