CSV-zu-Markdown-Tabellen-Konverter
Wandelt CSV-Dateien in Markdown-Tabellensyntax (`| col1 | col2 |`) um. Trennzeichen, ob die erste Zeile als Kopfzeile verwendet wird, und die Spaltenausrichtung (links, zentriert, rechts) können festgelegt werden. Das Ergebnis kann kopiert oder heruntergeladen werden. Die Umwandlung erfolgt vollständig im Browser; es werden keine Daten an einen Server gesendet.
| Trennzeichen |
|
|---|---|
| Erste Zeile als Kopfzeile verwenden | |
| Spaltenausrichtung |
|
Gib CSV-Daten ein, um hier die erzeugte Markdown-Tabelle zu sehen.
Wie eine CSV-Zeile in eine Markdown-Tabelle übertragen wird
| Eine CSV-Zeile | name,age,city |
|---|---|
| Resultierende Markdown-Syntax | | name | age | city | |
Wird die erste Zeile als Kopfzeile verwendet, wird sie zur Kopfzeile, gefolgt von einer Trennzeile (---), die die Ausrichtung angibt, und jede weitere Zeile wird zu einer Datenzeile.
Was ist ein CSV-zu-Markdown-Tabellen-Konverter
Eine Markdown-Tabelle besteht ausschließlich aus Pipes und Bindestrichen. Das macht sie als reinen Text gut lesbar, ist aber mühsam von Hand zu tippen, sobald mehr als eine Handvoll Spalten im Spiel sind. Liegen die Ausgangsdaten bereits als CSV vor – exportiert aus einer Tabellenkalkulation, als Ergebnis einer Datenbankabfrage oder aus einer Protokolldatei – gibt es keinen Grund, sie Zelle für Zelle neu einzutippen. Dieses Tool liest die CSV-Daten ein und erzeugt daraus eine vollständige Markdown-Tabelle: eine Kopfzeile, eine Trennzeile, die die Spaltenausrichtung markiert, und pro Eingabezeile eine Datenzeile.
Da eine Markdown-Tabellenzeile physisch in eine einzige Zeile passen muss, laufen bei der Umwandlung automatisch einige Anpassungen mit. Pipe-Zeichen innerhalb einer Zelle werden maskiert, damit sie nicht als Spaltengrenze missverstanden werden, und Zeilenumbrüche in mehrzeiligen, in Anführungszeichen gesetzten Zellen werden zu einem einzigen Leerzeichen zusammengefasst. Für die Spalten können Sie außerdem eine linksbündige, zentrierte oder rechtsbündige Ausrichtung wählen, wodurch das passende Muster aus Doppelpunkten und Bindestrichen in die Trennzeile eingefügt wird. Der gesamte Vorgang läuft lokal in Ihrem Browser ab, sodass die eingefügten CSV-Daten Ihren Rechner nie verlassen.
So erstellen Sie aus CSV eine Markdown-Tabelle
- CSV-Daten einfügen Fügen Sie den CSV-Text in das Eingabefeld ein. Wenn er direkt aus einer Tabellenkalkulation kopiert wurde, stellen Sie das Trennzeichen auf Tabulator statt Komma um.
- Entscheiden, ob die erste Zeile eine Kopfzeile ist Enthält die erste Zeile die Spaltennamen, aktivieren Sie „Erste Zeile als Kopfzeile verwenden“ – die Trennzeile wird dann automatisch darunter eingefügt.
- Spaltenausrichtung wählen Numerische Spalten lassen sich rechtsbündig meist besser lesen. Lassen Sie die Ausrichtung auf „Keine“, greift die Standardeinstellung des jeweiligen Renderers.
- Ergebnis in Ihr Dokument kopieren Kopieren Sie das erzeugte Markdown und fügen Sie es in ein README, ein Issue, eine Pull-Request-Beschreibung oder einen Fachartikel ein.
Tipps für die Nutzung
- Ein Pipe-Zeichen (|) innerhalb einer Zelle wird automatisch als \| maskiert, damit es nicht mit einem Spaltentrenner verwechselt wird.
- Zeilenumbrüche innerhalb mehrzeiliger, in Anführungszeichen gesetzter Zellen werden durch ein Leerzeichen ersetzt, da eine Markdown-Tabellenzeile physisch in eine einzige Zeile passen muss.
- Bei Auswahl von "Links", "Zentriert" oder "Rechts" wird `:---`, `:---:` bzw. `---:` in die Trennzeile eingefügt, sodass Renderer wie GitHub die Spalten in der gewünschten Ausrichtung anzeigen.
- Kombinieren Sie dies mit den Schwester-Tools CSV zu JSON und CSV zu SQL, um dieselbe CSV in das jeweils benötigte Ausgabeformat umzuwandeln.
Wo sich ein CSV-zu-Markdown-Konverter bewährt
Tabellen in einem README
Ordnen Sie eine Kompatibilitätsmatrix oder eine Liste von Konfigurationsoptionen zunächst in einer Tabellenkalkulation an und konvertieren Sie sie anschließend – Sie erhalten eine saubere Markdown-Tabelle, ohne Spaltenbreiten von Hand anzupassen.
Vergleiche in Issues und Pull Requests
Verwandeln Sie Benchmark-Ergebnisse oder eine Auswahl an Optionen direkt in eine Tabelle. Da es weiterhin reiner Text ist, lässt sie sich auch in einem Diff gut lesen.
Daten für einen Fachartikel aufbereiten
Messdaten lassen sich direkt als Tabelle in einen Artikel übernehmen. Rechtsbündige numerische Spalten halten die Ziffern ausgerichtet und leicht überschaubar.
Protokolle und Dokumentation aufräumen
Nützlich, wenn eine Liste, die bisher in einer Tabellenkalkulation gepflegt wurde, in eine als Markdown geführte Dokumentation umzieht.
Begriffe rund um Markdown-Tabellen
- Tabellensyntax
- Die Markdown-Notation, um eine Tabelle als durch Pipes getrennte Zellen darzustellen. Sie war nicht Teil der ursprünglichen Spezifikation und wurde später als Erweiterung ergänzt.
- Trennzeile
- Die Zeile aus Bindestrichen direkt unter der Kopfzeile. Sie teilt dem Parser mit, wo die Kopfzeile endet und die Daten beginnen.
- Ausrichtungsmarkierung
- Ein Doppelpunkt neben den Bindestrichen der Trennzeile, der links-, zentriert oder rechtsbündige Ausrichtung für diese Spalte angibt.
- GFM
- Kurz für GitHub Flavored Markdown, eine von GitHub definierte erweiterte Spezifikation, die zum De-facto-Standard für die Tabellensyntax geworden ist.
- Maskierung
- Das Voranstellen eines Backslashes vor ein Pipe-Zeichen innerhalb einer Zelle, damit es nicht als Spaltentrenner missverstanden wird.
Häufig gestellte Fragen
Übrigens – Warum Markdown-Tabellen nur Pipes und Bindestriche brauchen
Markdown wurde 2004 von John Gruber und Aaron Swartz als leichtgewichtige Auszeichnungssprache entwickelt, deren Kerngedanke lautet, dass reiner Text auch dann noch verständlich sein soll, wenn er unverändert gelesen wird. Die Tabellensyntax bildet da keine Ausnahme: Da Linien ausschließlich mit Pipes und Bindestrichen gezeichnet werden, sind keine öffnenden und schließenden Tags wie beim HTML-<table> nötig, und die Form der Tabelle lässt sich bereits am unverarbeiteten Quelltext erahnen.
Die Tabellensyntax war nie Teil von John Grubers ursprünglicher Markdown-Spezifikation; sie wurde später als Erweiterung durch PHP Markdown Extra und, einflussreicher, durch GitHub Flavored Markdown (GFM) hinzugefügt. Deshalb bestehen zwischen den Implementierungen weiterhin subtile Verhaltensunterschiede (etwa im Umgang mit uneinheitlicher Spaltenzahl), und die meisten großen Plattformen – GitHub, GitLab und Ähnliche – folgen weitgehend dem GFM.
Das Bedürfnis, das Ergebnis einer Tabellenkalkulation oder Datenbankabfrage direkt in die Dokumentation einzufügen, entsteht ständig beim Schreiben von READMEs, Issues und technischen Blogartikeln. Pipes und Trennzeilen von Hand einzutippen ist mühsam, weshalb ein CSV-Konverter per Mausklick zu einem festen Vorbereitungsschritt für alle geworden ist, die Dokumentation in Markdown schreiben.