CSV in Markdown konvertieren

1. 1

   CSV ablegen

   Ziehen Sie eine .csv-, .tsv-, .txt- oder .psv-Datei auf die Seite oder wählen Sie sie aus. Trennzeichen, Anführungszeichen und Kodierung werden aus der Datei selbst gelesen, und das Tool nennt seine Wahl.

2. 2

   Gerenderte Vorschau prüfen

   Die Vorschau zeigt die Tabelle so, wie sie gerendert wird, nicht nur den rohen Text — Sie sehen also sofort, ob eine Zelle mit einem Sternchen oder einem Zeilenumbruch sich richtig verhält.

3. 3

   Ausrichtung und Formatierung einstellen

   Wählen Sie eine Ausrichtung für die ganze Tabelle oder je Spalte über den Vorschaukopf. Schalten Sie die ausgerichtete Ausgabe für lesbaren Rohtext ein, die Maskierung für Zellen mit Markdown-Zeichen, nummerierte Zeilen oder eine fette erste Zeile oder Spalte.

4. 4

   Kopieren oder herunterladen

   Auf Konvertieren klicken, dann Kopieren, um die Tabelle für ein README oder einen Pull Request in die Zwischenablage zu legen — oder als .md-Datei mit dem Namen Ihrer Wahl herunterladen. Alles läuft auf Ihrem Gerät.

Konvertieren Sie CSV in eine GitHub-Flavored-Markdown-Tabelle, mit den beiden Dingen, die über die Brauchbarkeit des Ergebnisses entscheiden: korrekte Maskierung und Kontrolle darüber, wie jede Spalte ausgerichtet ist. Nutzen Sie die erste Zeile als Kopfzeile oder lassen Sie Bezeichnungen generieren, setzen Sie die Ausrichtung für die Tabelle oder je Spalte, richten Sie die Ausgabe aus oder halten Sie sie kompakt, und sehen Sie die gerenderte Tabelle neben dem rohen Markdown, bevor Sie kopieren.

• Markdown-Tabellenformat — GitHub-Flavored Markdown: eine Kopfzeile, eine Trennzeile mit der Ausrichtung, dann eine Zeile je Datensatz. Das rendert in GitHub, GitLab, Obsidian, Notion, VS Code, Jira und Confluence ohne Änderungen.
• Ausrichtung je Spalte — Setzen Sie einen Standard für die Tabelle und überschreiben Sie einzelne Spalten über das Auswahlfeld im Vorschaukopf. Links, mittig, rechts oder keine.
• Erste Zeile als Kopfzeile — Verwenden Sie die erste CSV-Zeile als Tabellenkopf oder schalten Sie es ab, um jede Zeile als Daten mit generierten Bezeichnungen Col 1, Col 2 zu behandeln.
• Maskierung, die hält — Pipes und Backslashes werden immer maskiert, Zeilenumbrüche in einer Zelle werden zu <br>, und Sternchen, Unterstriche, Backticks, Klammern, spitze Klammern und Tilden können ebenfalls maskiert werden.
• Ausgerichtet oder kompakt — Richten Sie jede Spalte aus, damit die Rohdatei in einem Texteditor untereinander steht, oder halten Sie sie kompakt, damit eine neu erzeugte Tabelle den kleinstmöglichen Diff erzeugt.
• Gerenderte Vorschau und Rohansicht — Sehen Sie die Tabelle so, wie sie gerendert wird, und das Markdown so, wie es geschrieben wird, und wechseln Sie zwischen beiden. Jede Einstellung verändert mindestens eine der beiden.
• Kopieren oder herunterladen — Legen Sie die Tabelle direkt in die Zwischenablage für ein README oder einen Pull Request, oder laden Sie sie als .md-Datei mit einem Namen Ihrer Wahl herunter.

Eine Markdown-Tabelle besteht aus drei Arten von Zeilen, und zu wissen, welche welche ist, erklärt jede Option auf dieser Seite. Das Tool schreibt alle drei für Sie, aber die Form lohnt das Verständnis — sie entscheidet, wo eine Tabelle zerbricht.

Die Kopf- und die Trennzeile

• Kopfzeile — Eine Zeile aus Zellen zwischen Pipes. Sie wird immer fett gerendert — deshalb bewirkt erneutes Fettsetzen nichts, und deshalb wirken die Fett-Optionen dieses Tools auf den Tabellenkörper.
• Trennzeile — Die Strichzeile direkt unter der Kopfzeile. Sie ist keine Dekoration: Erst ihre Anwesenheit macht den Block zu einer Tabelle, und die Doppelpunkte darin sind die einzige Möglichkeit, die Ausrichtung zu setzen.
• Datenzeilen — Eine Zeile je Datensatz. Eine Zeile mit weniger Zellen als der Kopf wird aufgefüllt; eine mit mehr würde von den meisten Renderern abgeschnitten, deshalb werden ungleichmäßige Dateien auf die breiteste Zeile gebracht.

Die zwei Dinge, die eine Tabelle zerstören

• Eine unmaskierte Pipe — Eine Pipe in einer Zelle beendet diese Zelle vorzeitig, die Zeile bekommt eine Spalte mehr, und der Renderer verschiebt oder verliert die Daten. Dieses Tool maskiert jede Pipe, immer — das ist keine Option, weil es keinen Fall gibt, in dem das rohe Zeichen gemeint war.
• Ein Zeilenumbruch in einer Zelle — Eine Markdown-Tabellenzeile ist genau eine Zeile. Ein zitiertes CSV-Feld mit einem Umbruch — eine Postanschrift, ein Kommentar — würde die Zeile mittendrin beenden, und jede folgende Zeile fiele aus der Tabelle. Die drei Wege, wie dieses Tool damit umgeht, stehen im Abschnitt zu Zeilenumbrüchen weiter unten.

Die Ausrichtung steckt in der Trennzeile, als Doppelpunkte. Dieses Tool schreibt sie für Sie, und sie darf je Spalte unterschiedlich sein — genau das will man, sobald eine Tabelle Bezeichnungen und Zahlen mischt.

• Links — :--- — Der Standard und richtig für Namen, Bezeichnungen und Fließtext. Ein Doppelpunkt links der Striche.
• Mittig — :---: — Doppelpunkte auf beiden Seiten. Nützlich für kurze Statusspalten und Ein-Zeichen-Markierungen, wo Zentrieren besser liest als ein ausgefranster linker Rand.
• Rechts — ---: — Ein Doppelpunkt rechts. Das ist die entscheidende für Zahlen: rechtsbündige Werte stehen am Dezimaltrennzeichen untereinander, sodass sich eine Spalte mit Preisen oder Stückzahlen mit dem Auge vergleichen lässt.
• Keine — --- — Gar keine Doppelpunkte. Der Renderer nutzt seinen eigenen Standard — links, in allen uns bekannten — und die Trennzeile bleibt so kurz wie möglich.
• Je Spalte — Jeder Spaltenkopf in der Vorschau hat sein eigenes Auswahlfeld. Setzen Sie den Tabellenstandard einmal und stellen Sie dann die beiden Zahlenspalten auf Rechts: Eine Tabelle aus Namen und Zahlen liest sich mit etwa vier Klicks korrekt.

Text aus einer Tabellenkalkulation ahnt nicht, dass er gleich Markdown wird, und mehrere völlig gewöhnliche Zeichen bedeuten dann etwas. Das Tool trennt, was es immer korrigiert, von dem, was Sie wählen.

Immer maskiert

• Pipes — Werden als \| geschrieben. Eine unmaskierte Pipe beendet die Zelle, was Daten verschiebt oder verliert — davon will niemand eine Variante, deshalb ist es kein Schalter.
• Backslashes — Werden zu \\ verdoppelt, und zwar zuerst, damit die von allen anderen Regeln ergänzten Backslashes nicht ihrerseits verdoppelt werden. Ein Windows-Pfad in einer Zelle überlebt unversehrt.

Ihre Wahl

• Markdown-Zeichen — Sternchen, Unterstriche, Backticks, Klammern, spitze Klammern und Tilden. Eine Zelle mit *Hinweis* wird kursiv gerendert, die Sternchen verschwinden; maskiert liest sie sich als *Hinweis*. Standardmäßig aus, weil die meisten Tabellen keines dieser Zeichen enthalten und die Backslashes in der Rohdatei sichtbar sind.
• Zeilenumbrüche: <br> — Der Standard. Ein Umbruch in einer Zelle wird zu einem HTML-Zeilenumbruch, den jeder Markdown-Renderer mit Tabellenunterstützung ebenfalls unterstützt — eine mehrzeilige Anschrift bleibt eine Zelle und bleibt lesbar.
• Zeilenumbrüche: \n — Ein wörtliches Backslash-n. Richtig, wenn die Tabelle irgendwohin geht, wo HTML entfernt wird, und wenn wichtig ist, dass dort ein Umbruch war, ohne ihn zu rendern.
• Zeilenumbrüche: Leerzeichen — Der Umbruch wird zu einem einzelnen Leerzeichen. Die kürzeste Ausgabe, und die richtige Wahl, wenn die Umbrüche ein Artefakt des Exports sind und keine Bedeutung tragen.
• Was nicht maskiert wird — Bindestriche, Punkte und Pluszeichen bleiben unangetastet. Sie zu maskieren ist technisch zulässig und macht aus jedem Datum 2026\-01\-01 und aus jedem Preis 12\.50 — das braucht kein Renderer und will kein Leser.

Die Hälfte dessen, was eine konvertierte Tabelle falsch macht, passiert, bevor überhaupt Markdown geschrieben wird. Diese drei Einstellungen entscheiden, was die Zeilen überhaupt sind, und alle drei werden aus der Datei erkannt, mit einer Übersteuerung daneben.

• Trennzeichen — Komma, Semikolon, Tabulator oder Pipe, erkannt durch Analyse einer Stichprobe mit jedem Kandidaten und Auswahl der gleichmäßigsten Zeilenbreiten. Trennzeichen in der ersten Zeile zu zählen — die übliche Abkürzung — liest "a,b,c,d";"e";"f" als kommagetrennt und presst jede Zeile in eine einzige Spalte.
• Anführungszeichen — Doppeltes Anführungszeichen, Apostroph oder keines, auf dieselbe Weise erkannt. Ein Anführungszeichen öffnet ein Feld nur an erster Position, sodass ein Apostroph in O'Brien ein Apostroph bleibt statt den Rest der Zeile zu verschlucken.
• Kodierung — Standardmäßig Auto: Die Byte-Order-Mark gewinnt, wenn die Datei eine hat; sonst werden die Bytes auf gültiges UTF-8 geprüft und fallen auf Windows-1252 zurück. Erzwingen Sie UTF-8, UTF-16LE, UTF-16BE, Windows-1252 oder ISO-8859-1, wenn eine Datei keine Marke trägt und die Vermutung danebenliegt.
• ISO-8859-1 ist nicht Windows-1252 — Die Webplattform behandelt Ersteres als Bezeichner für Letzteres, deshalb bieten die meisten Werkzeuge beides an und liefern eines. Hier ist ISO-8859-1 wirklich Byte-zu-Codepoint-Latin-1, was für Dateien zählt, in denen 0x80 bis 0x9F Steuerzeichen sind und keine typografischen Anführungszeichen.
• Byte-Order-Marks — Der CSV-UTF-8-Export von Excel schreibt eine, und ein Werkzeug, das sie nicht entfernt, setzt ein unsichtbares Zeichen vor Ihre erste Spaltenüberschrift. Hier wird sie entfernt, und widerspricht sie der von Ihnen gewählten Kodierung, sagt das Tool es, statt Sie stillschweigend zu übergehen.

Beide erzeugen dieselbe gerenderte Tabelle. Der Unterschied liegt im Aussehen der Rohdatei — und welche Sie wollen, hängt ganz davon ab, wer sie so liest.

• Ausgerichtet — Jede Zelle wird aufgefüllt, damit die Pipes untereinander stehen. Das rohe Markdown liest sich in jedem Texteditor als Tabelle — genau das, was man will, wenn jemand die .md-Datei öffnet statt einer gerenderten Seite.
• Kompakt — Ein Leerzeichen links und rechts jeder Zelle, mehr nicht. Die Ausgabe ist kleiner und — nützlicher — ein geänderter Wert in einer Zeile füllt nicht alle anderen Zeilen neu auf, sodass eine neu erzeugte, in Git versionierte Tabelle einen einzeiligen Diff statt eines Diffs über die ganze Datei erzeugt.
• Auffüllen folgt der Ausrichtung — Eine rechtsbündige Spalte wird links aufgefüllt, eine zentrierte auf beiden Seiten. So steht der Rohtext genauso untereinander wie später die gerenderte Tabelle — und darum geht es beim Auffüllen.
• Nummerierte Zeilen — Fügt eine führende Spalte hinzu, die die Datenzeilen ab eins zählt. Nützlich, um in einem Review-Kommentar auf eine Zeile zu verweisen, und kein Teil Ihrer Daten: Sie wird jedes Mal neu erzeugt, wenn die Tabelle es wird.
• Erste Zeile oder Spalte fett — Setzt die erste Datenzeile oder die erste Spalte jeder Datenzeile in doppelte Sternchen. Die Kopfzeile ist beim Rendern ohnehin fett, deshalb wirken diese Optionen bewusst auf den Tabellenkörper — die Kopfzeile erneut fett zu setzen wäre ein Schalter, der nichts tut.

Ein 25-MB-Export — rund 225.000 Zeilen — wird auf einem Desktop in etwa einer Sekunde konvertiert, in einem Hintergrund-Thread, sodass die Seite nie einfriert.

Echte Exporte sind selten nur eine Kopfzeile und Daten. Vier Einstellungen kümmern sich um die Teile, die keine Tabellenzellen werden sollten.

• Führende Zeilen überspringen — Entfernt Zeilen von oben, bevor irgendetwas anderes geschieht. Berichte und Dashboard-Exporte tragen häufig einen Titel, ein Datum und eine Leerzeile über der eigentlichen Kopfzeile; überspringen Sie diese, und Zeile eins wird die Kopfzeile, die sie hätte sein sollen.
• Zeilen begrenzen — Deckelt, wie viele Datenzeilen geschrieben werden. Ein README will die ersten zwanzig Zeilen eines großen Exports, nicht alle vierzigtausend — und die Vorschau zeigt genau, was erzeugt wird.
• Leere Zeilen entfernen — Entfernt jede Zeile, in der alle Zellen leer sind. Tabellenkalkulations-Exporte sammeln diese am Ende, und jede wird zu einer Zeile leerer Zellen in der Tabelle.
• Leere Spalten entfernen — Entfernt jede Spalte ohne Daten. Wenn eine Kopfzeile verwendet wird, hält die Überschrift allein die Spalte nicht: Eine ungenutzte Spalte mit Namen ist genau der Fall, für den diese Einstellung existiert, und ihre Überschrift geht mit ihr.

Eine Datei wird im kostenlosen Tarif mit allen Formatierungsoptionen konvertiert. Viele auf einmal zu konvertieren ist das, was der Pro-Tarif ergänzt — und es kommt in zwei Formen, weil das zwei wirklich verschiedene Aufgaben sind.

• Ein Stapel Dateien — Stellen Sie bis zu fünfzig CSV-Dateien in die Warteschlange, konvertieren Sie sie in einer Aktion und nehmen Sie sie als ein einziges ZIP mit. Doppelte Dateinamen werden im Archiv eindeutig gemacht statt einander zu überschreiben.
• Ein zusammengeführtes Dokument — Dieselbe Warteschlange in eine einzige Markdown-Datei geschrieben, jede Tabelle unter einer Überschrift aus ihrem Dateinamen. Das ist die Form, die man für eine Dokumentationsseite will, die vier verwandte Tabellen an einem Ort zeigen muss.
• Einstellungen gelten für die Warteschlange — Ausrichtung, Auffüllen, Maskierung und der Rest gelten für jede Datei im Stapel, sodass eine Reihe von Exporten einheitlich herauskommt. Die Ausrichtung je Spalte bleibt je Datei, weil die Spalten sich unterscheiden.
• Weiterhin auf Ihrem Gerät, nicht auf unseren Servern — Ein Stapel ist dieselbe Engine, nur öfter ausgeführt. Nichts wird hochgeladen, die Warteschlange ist durch Ihren eigenen Speicher begrenzt und nicht durch einen Server, und die Größenobergrenze im Pro-Tarif ist das, was Ihr Gerät schafft.

Die Tabelle, die dieses Tool schreibt, ist GitHub-Flavored Markdown — der Dialekt, auf den sich fast alles geeinigt hat. Ein paar Ziele haben Eigenheiten, die man vor dem Einfügen kennen sollte.

• GitHub und GitLab — READMEs, Issues, Pull-Request-Beschreibungen und Wikis. Die Ausrichtungs-Doppelpunkte werden beachtet, und <br> in einer Zelle wird als Zeilenumbruch gerendert.
• Obsidian und VS Code — Beide rendern Tabellen in der Vorschau und beide lesen ständig die Rohdatei — genau der Fall, für den die ausgerichtete Ausgabe da ist.
• Notion — Das Einfügen einer Markdown-Tabelle erzeugt eine echte Notion-Tabelle. Die Ausrichtung wird nicht übernommen, die Doppelpunkte schaden also nicht, bewirken aber auch nichts.
• Jira und Confluence — Modernes Jira wandelt eine eingefügte Markdown-Tabelle um. Älteres Confluence nutzt eigenes Tabellen-Markup — fügen Sie dort in ein Markdown-Makro ein statt in den Seitenkörper.
• Static-Site-Generatoren — Jekyll, Hugo, Docusaurus, MkDocs und Astro rendern GFM-Tabellen in Inhaltsdateien. Kompakte Ausgabe hält die Quell-Diffs klein, wenn eine Tabelle aus Daten neu erzeugt wird.

Markdown-Tabellen werden in READMEs, Dokumentation und statischen Seiten eingesetzt. CSV in Markdown zu konvertieren erlaubt es, tabellarische Daten in Markdown-Inhalte einzubetten — und hält sie in derselben Versionsverwaltung wie den Code, den sie dokumentieren.

• Doku und READMEs — Setzen Sie Tabellen in die Dokumentation, ohne eine einzige Pipe zu tippen, und ohne einen Screenshot, der veraltet, sobald sich die Zahlen ändern.
• Portabler Text — Markdown hält Daten in Repositories, Wikis und statischen Generatoren lesbar — und als Klartext lesbar, wenn gar nichts sie rendert.
• Im Diff überprüfbar — Eine als Text gespeicherte Tabelle zeigt zeilenweise, was sich in einem Pull Request geändert hat. Eine dem gleichen Commit beigelegte Tabellenkalkulation zeigt nichts.
• Keine Abhängigkeit zu installieren — Das Ergebnis ist Text. Es braucht dort, wo es landet, kein Plugin, keine Erweiterung und keine Laufzeitumgebung — was für ein eingebettetes Blatt oder ein Diagrammbild nicht gilt.

• Trennzeichen — Automatische Erkennung über Gleichmäßigkeit, oder wählen Sie Komma, Semikolon, Tabulator oder Pipe.
• Anführungszeichen — Automatische Erkennung, doppeltes Anführungszeichen, Apostroph oder keines.
• Kodierung — Auto mit Byte-Order-Mark-Erkennung, UTF-8, UTF-16LE, UTF-16BE, Windows-1252 oder ein echtes ISO-8859-1.
• Erste Zeile als Kopfzeile — Eingeschaltet ist Zeile eins der Tabellenkopf; ausgeschaltet sind alle Zeilen Daten und es werden Bezeichnungen Col 1, Col 2 erzeugt.
• Ausrichtung — Links, mittig, rechts oder keine für die Tabelle, je Spalte über den Vorschaukopf überschreibbar.
• Ausgerichtete Ausgabe — Bringen Sie die Spalten in der Rohdatei untereinander, oder halten Sie sie kompakt für kleinere Diffs.
• Markdown-Zeichen maskieren — Maskiert Sternchen, Unterstriche, Backticks, Klammern, spitze Klammern und Tilden zusätzlich zu den immer maskierten Pipes und Backslashes.
• Zeilenumbrüche in einer Zelle — Machen Sie aus einem Umbruch <br>, ein wörtliches \n oder ein Leerzeichen.
• Nummerierte Zeilen, fette Zeile, fette Spalte — Eine zählende Spalte, eine fette erste Datenzeile und eine fette erste Spalte — unabhängig voneinander.
• Überspringen, begrenzen und bereinigen — Entfernen Sie führende Zeilen, deckeln Sie die Zeilenzahl und entfernen Sie Zeilen und Spalten ohne Inhalt.
• Herunterladen als — Eigener Dateiname für die .md-Datei; die Endung wird ergänzt, wenn Sie sie weglassen.

• CSV zu JSON
• CSV zu XML
• CSV zu Excel
• CSV-Tools
• An OpenDocument spreadsheet

  Same typed columns and frozen header, for readers who use LibreOffice rather than Excel

• Cut it down first

  A README wants the rows that matter, not all forty thousand of them