Konvertieren Sie CSV in Markdown online kostenlos

Konvertieren Sie CSV-Dateien kostenlos online in Markdown. Datei hochladen und sofort eine saubere, für LLMs geeignete Ausgabe erhalten. Ohne Anmeldung, bis 50 MB, nichts wird gespeichert.

CSV in eine Markdown-Tabelle umwandeln: einen Tabellenexport für ein Modell lesbar machen

Rohes CSV kann ein Sprachmodell durchaus lesen. Trotzdem ist es eine miserable Art, ihm Daten zu geben. Jede Zeile ist eine kommagetrennte Kette von Werten ohne optischen Halt, die Kopfzeile steht ein einziges Mal ganz oben, und ab Zeile vierzig zählt das Modell Kommas, um herauszufinden, welches Feld gerade dran ist. Fragen Sie nach der Marge des dritten Produkts, bekommen Sie eine Antwort, die sich sehr sicher ist — und sich in der Spalte irrt.

Eine Markdown-Pipe-Tabelle räumt das auf. Die Spalten stehen untereinander, die Kopfzeile ist durch die Trennlinie darunter ausdrücklich als Kopfzeile ausgewiesen, und jede Zelle sitzt an einer sichtbar eindeutigen Stelle. Modelle kommen mit diesem Format gut zurecht — es steckt millionenfach in ihren Trainingsdaten, in READMEs, in Dokumentation, in GitHub-Issues. Laden Sie oben eine .csv-Datei hoch, und Sie haben die Tabelle in Sekunden. Kostenlos, ohne Anmeldung, nichts wird gespeichert.

CSV zu Markdown konvertieren: was Ihnen eine Pipe-Tabelle einbringt

Auf dem Papier ist der Unterschied klein, in der Praxis groß:

  • Die Kopfzeile ist eindeutig. Die Trennzeile |---|---| sagt jedem Markdown-Parser — und jedem Modell, das eine Million davon gesehen hat —, dass darüber Spaltennamen stehen und keine Daten.
  • Spaltenweises Denken wird leichter. Fragen wie „welche Region entwickelt sich nach unten“ oder „finde den Ausreißer in der Preisspalte“ erfordern senkrechtes Lesen. Eine Pipe-Tabelle macht dieses senkrechte Lesen strukturell möglich, Kommaketten tun das nicht.
  • Leere Zellen bleiben sichtbar. Im rohen CSV übersieht man a,,c schnell. Als | a | | c | springt die Lücke ins Auge — und darauf kommt es an, wenn gerade die fehlenden Daten die Frage sind.
  • Sie übersteht das Einfügen. Werfen Sie die Tabelle in einen Chat, einen GitHub-Kommentar, eine Notion-Seite oder eine Doku-Website, und sie erscheint als echte Tabelle statt als Textbrei — und sie liegt im Prompt friedlich neben Fließtext und Quellcode, ohne dass das Modell die drei durcheinanderbringt.

Trennzeichen, Anführungszeichen und warum „CSV“ eine Lüge ist

Es gibt keinen einheitlichen CSV-Standard, sondern nur einen groben Konsens, von dem ständig abgewichen wird. Das Parsen muss deshalb mit mehreren Realitäten fertig werden:

Das Trennzeichen ist nicht immer ein Komma. Exporte aus Systemen mit deutscher, französischer, spanischer oder niederländischer Locale verwenden typischerweise Semikolons, weil dort das Komma das Dezimaltrennzeichen ist. Tabulatorgetrennte Dateien werden andauernd mit der Endung .csv abgelegt. Pipe-getrennte Dateien fallen aus älteren Datenbankexporten heraus. Die Erkennung des Trennzeichens funktioniert über eine Stichprobe der ersten Zeilen und wählt den Kandidaten, der eine gleichbleibende Feldanzahl ergibt — im Normalfall verlässlich, und austricksbar von einer Datei, deren erste Zeilen zufällig viele Semikolons im Freitext enthalten.

In Anführungszeichen stehende Felder enthalten das Trennzeichen. Der klassische Fall ist eine Anschrift: "Smith, John",42,"London, UK" sind drei Felder, nicht fünf. Alles, was in doppelte Anführungszeichen gefasst ist, gilt als ein Wert, ganz gleich, was darin steht — Zeilenumbrüche eingeschlossen. Eine Kommentarspalte mit mehrzeiligem Text ist gültiges CSV und läuft über mehrere Zeilen der Datei, bleibt aber eine einzige Zelle. Ein Anführungszeichen innerhalb eines solchen Feldes wird durch Verdopplung maskiert: "She said ""no""". All das wird sauber behandelt — genau deshalb scheitert ein naives Skript, das am Komma trennt, an echten Exporten, und ein richtiger Parser eben nicht.

Eine Folge davon sollten Sie kennen: Stehen in Ihren Daten echte Pipe-Zeichen, müssen sie in der Markdown-Ausgabe maskiert werden, sonst zerlegen sie die Tabelle. Das passiert automatisch, bedeutet aber, dass eine Zelle mit a|b in der Ausgabe leicht anders aussieht als in der Quelle.

Kopfzeilen, ausgefranste Zeilen und Dateien, die keine richtigen Tabellen sind

Eine CSV-Datei hat keine Möglichkeit zu erklären, ob ihre erste Zeile eine Kopfzeile ist. Das wird erschlossen: Besteht die erste Zeile durchgehend aus Text und stehen darunter Zahlen oder Datumsangaben, sind es mit ziemlicher Sicherheit Spaltennamen. Sehen alle Zeilen gleich aus, wird die erste trotzdem als Kopfzeile genommen, weil das der mit Abstand häufigste Fall ist. Hat Ihre Datei tatsächlich keine Kopfzeile, finden Sie Ihren ersten Datensatz in die Kopfzeile befördert. Fällt sofort auf und ist leicht zu beheben, indem Sie vor dem Umwandeln eine Kopfzeile ergänzen.

Ausgefranste Zeilen — Zeilen mit mehr oder weniger Feldern als die Kopfzeile — sind die zweite übliche Macke. Sie stammen aus handgepflegten Dateien, aus einem verirrten, nicht maskierten Anführungszeichen weiter oben, das alles Nachfolgende verschiebt, oder aus Exporten, die unten noch eine Summenzeile anhängen. Markdown-Tabellen brauchen eine feste Spaltenzahl, also werden zu kurze Zeilen aufgefüllt und die Form bleibt gültig. Wirkt ein ganzer Abschnitt Ihrer Tabelle um eine Spalte verrutscht, suchen Sie darüber nach einem unpaarigen Anführungszeichen — daran liegt es fast immer.

BI-Werkzeuge setzen gerne einen Berichtstitel und ein Datum vor die eigentliche Kopfzeile. Diese Zeilen werden als Teil der Tabelle gelesen. Löschen Sie sie vorher.

CSV nach Excel-Art und seine Eigenheiten

Ein erheblicher Teil aller CSV-Dateien dieser Welt stammt aus Excel, und Excel hinterlässt Fingerabdrücke:

  • Ein BOM am Anfang. Excel schreibt bei UTF-8-Exporten eine Byte Order Mark, die in Werkzeugen, die sie nicht entfernen, als unsichtbarer Müll am ersten Spaltennamen klebt. Hier fliegt sie raus.
  • Zahlen in Exponentialschreibweise. Lange Kennnummern landen als 1.23457E+14 in der Datei, weil Excel sie für Zahlen hielt. Dieser Schaden entsteht in der Tabellenkalkulation, bevor die CSV überhaupt existiert — kein Konverter macht das rückgängig. Formatieren Sie die Spalte in der Quelle als Text, bevor Sie exportieren.
  • Führende Nullen weg. Postleitzahlen und Artikelnummern verlieren sie auf demselben Weg.
  • Datumsangaben umformatiert auf die Locale des Rechners, weshalb 03/04 für immer mehrdeutig bleibt.
  • Latin-1-Exporte. „Speichern unter CSV“ schreibt auf manchen Windows-Versionen Windows-1252 statt UTF-8. Kommen Umlaute oder typografische Anführungszeichen als é oder “ heraus, ist das Mojibake aus einer falsch deklarierten Zeichenkodierung — exportieren Sie erneut als CSV UTF-8, dann ist es weg.

Haben Sie noch die Arbeitsmappe statt nur den Export, erspart Ihnen die direkte Umwandlung mit Excel zu Markdown das meiste davon — in XLSX bleiben die Zelltypen erhalten, und Sie bekommen sämtliche Blätter statt nur dem einen, das beim Speichern gerade aktiv war.

Wann Markdown die falsche Wahl ist

Pipe-Tabellen haben eine Größenobergrenze, und sie liegt niedriger, als viele vermuten. Jede Zeile bezahlt ihre Pipes und ihre Auffüllzeichen, eine Tabelle kostet also merklich mehr Token als dieselben Daten als blanke Werte. Bei 200 Zeilen spielt das keine Rolle. Bei einem Export mit 50.000 Zeilen entscheidet es darüber, ob es ins Kontextfenster passt oder nicht.

Die Breite ist die zweite Grenze. Eine Tabelle mit vierzig Spalten bricht in den meisten Anzeigen zu unlesbarem Brei um, und der Vorteil der Ausrichtung, der das Format überhaupt gerechtfertigt hat, ist damit dahin. Irgendwo um ein Dutzend Spalten herum kippt die Abwägung in die andere Richtung.

Nehmen Sie für diese Fälle CSV zu reinem Text, wo Sie die Werte ohne das Tabellengerüst bekommen — besser für große Dateien, für Embeddings und für alles, was in ein Skript weitergereicht wird. Der Formatumschalter oben auf dieser Seite wechselt zwischen beiden und behält Ihre ausgewählte Datei, und der Token-Zähler unter der Ausgabe sagt Ihnen sofort, ob die Tabellenfassung in Ihr Budget passt.

Wo sich das bezahlt macht

  • Schnelle Auswertung im Chatfenster. Abfrageergebnis exportieren, umwandeln, einfügen, Fragen stellen. Bei ein paar hundert Zeilen ist das schneller, als Auswertungscode zu schreiben.
  • Dokumentation. Ein CSV-zu-Markdown-Tabellengenerator ist der kürzeste Weg von einer Konfigurationstabelle zu einer Tabelle in einer README oder auf einer Doku-Seite.
  • Datenkontrolle. Ausgerichtete Spalten machen Auffälligkeiten für Menschen sichtbar, nicht nur für Modelle — die eine Zeile mit vertauschtem Feld findet man in einer Tabelle deutlich leichter. Aus demselben Grund lesen sich Beispieldaten in einem GitHub-Issue als Tabelle besser denn als roher CSV-Codeblock.
  • Daten und Quellcode zusammenbringen. Wandeln Sie die CSV-Datei um, danach mit dem GitHub-zu-Text-Konverter Ihr Projekt, und lassen Sie ein Modell prüfen, ob Ihre Parser-Logik dem, was in der Datei steht, wirklich gewachsen ist.

Häufige Fragen

Wie wandle ich eine CSV-Datei in eine Markdown-Tabelle um?

Laden Sie die .csv-Datei oben hoch, und Sie erhalten eine Pipe-Tabelle zurück, fertig zum Einfügen in eine README, ein Issue, eine Doku-Seite oder einen Prompt. Kostenlos, 50 MB pro Datei, ohne Anmeldung. Die erste Zeile gilt als Kopfzeile — was praktisch jeder CSV-Export auch so liefert.

Und wenn meine CSV-Datei keine Kopfzeile hat?

Dann rückt der erste Datensatz in die Kopfzeile auf und fehlt Ihnen im Rumpf. Am einfachsten ergänzen Sie in der Quelldatei vor dem Hochladen eine Kopfzeile — auch Platzhalter wie col1,col2,col3 genügen, denn Markdown-Pipe-Tabellen verlangen syntaktisch eine Kopfzeile, und irgendetwas muss darin stehen.

Bis zu welcher Größe lohnt sich CSV zu Markdown überhaupt?

Praktisch bis zu ein paar hundert Zeilen. Markdown-Tabellen kennen keine Blätterung, keine Sortierung, kein Scrollen — eine Tabelle mit zehntausend Zeilen ist eine Wand aus Pipes, die niemandem hilft und beim Einfügen in ein Modell reichlich Kontext verbrennt. Filtern Sie die gewünschten Zeilen erst in der Tabellenkalkulation und wandeln Sie dann die Teilmenge um.

Werden Pipe-Zeichen in meinen Daten maskiert?

Das muss sein, denn ein nicht maskiertes | in einer Zelle würde als Spaltengrenze gelesen und alle folgenden Werte klammheimlich verschieben. Arbeiten Sie mit Daten, in denen Pipes vorkommen — Logzeilen, manche URLs, Kommandobeispiele —, prüfen Sie in der Ausgabe stichprobenartig eine betroffene Zeile, statt sich darauf zu verlassen.

Wird die Tabelle auf GitHub richtig dargestellt?

Ja. Herauskommen Pipe-Tabellen in GitHub Flavored Markdown, die Ausgabe erscheint also unverändert korrekt in READMEs, Issues, Pull-Request-Beschreibungen und Diskussionsbeiträgen. Dieselbe Syntax funktioniert in GitLab, in Obsidian, beim Import in Notion und in den meisten Static-Site-Generatoren.

Verwandte Konverter

File2Txt nimmt jede unterstützte Datei entgegen, wenn Ihnen eine Seite für alles lieber ist. Für andere strukturierte Formate: JSON zu Markdown und XML zu Markdown nehmen sich verschachtelter Daten an, die in kein flaches Raster passen, und HTML zu Markdown holt Tabellen aus gespeicherten Webseiten heraus. Dokumente laufen über PDF zu Markdown.

Auf der Code-Seite gibt es den GitLab-Konverter und einen Konverter für lokale Ordner, dazu Web2Txt zum Auslesen laufender Seiten. Der Leitfaden zum Datei-zu-Text-Konverter behandelt den größeren Arbeitsablauf.

Repo2Txt wird entwickelt und gepflegt von v12hero, einem unabhängigen Entwickler, der native und Web-Apps mit Fokus auf Privatsphäre baut.