CSV in Markdown-Tabelle umwandeln
Wer eine Markdown-Tabelle von Hand tippt, zählt in jeder Zeile senkrechte Striche und Bindestriche. Laden Sie stattdessen die CSV-Datei hoch und erhalten Sie eine Tabelle mit Kopfzeile und Trennzeile, die Sie direkt in eine README, eine Wiki-Seite oder ein Notebook einfügen können.
Daten-Konverter
oder CSV, TSV, TXT …-Dateien hierher ziehen ·
Max. 95 MB pro Datei· Bis zu 20 Dateien· Gelöscht nach 30 Minuten
Dateien werden auf unseren Servern verarbeitet und nach 30 Minuten gelöscht.
Zeichen, das Spalten in CSV- und Textdateien trennt, sowohl beim Lesen als auch beim Schreiben. Automatisch erkennt es anhand der Eingabe und schreibt Kommas.
UTF-8 funktioniert für jede Sprache. Wählen Sie UTF-8 mit BOM, wenn Excel unter Windows beim Öffnen der CSV-Datei Umlaute oder asiatische Zeichen fehlerhaft anzeigt.
Eingabe aus Excel, ODS und Numbers: nur das erste Blatt oder alle Blätter umwandeln (eine CSV pro Blatt in einer ZIP-Datei oder ein JSON-Schlüssel pro Blatt).
Name des Tabellenregisters in der neuen Tabelle, bis zu 31 Zeichen.
Array von Objekten verwendet Spaltennamen als Schlüssel für jede Zeile; Array von Arrays ist kompakter und behält die Kopfzeile als erstes Array.
Name des äußeren Elements, das alle Zeilen umschließt; jede Zeile wird darin zu einem <row>.
Wird in CREATE-TABLE- und INSERT-Anweisungen verwendet. Nur Buchstaben, Ziffern und Unterstriche.
Anführungszeichen und Spaltentypen unterscheiden sich leicht zwischen Datenbanken; wählen Sie die, in die Sie importieren.
Datumszellen in einem einheitlichen Format schreiben. ISO (2026-10-18) ist für Datenbanken und Code am sichersten; „Unverändert“ lässt sie so, wie sie in der Quelle stehen.
So verwenden Sie dieses Tool
- 1
CSV-Datei hochladen
Fügen Sie .csv-, .tsv- oder durch Trennzeichen getrennte .txt-Dateien hinzu, bis zu 20 gleichzeitig und je 95 MB. Die automatische Erkennung unterstützt Kommas, Semikolons, Tabulatoren und senkrechte Striche.
- 2
Kopfzeile bestätigen
Erste Zeile ist Kopfzeile ist aktiviert, sodass Zeile 1 zur Tabellenüberschrift wird. Deaktivieren Sie die Option unter Erweiterte Einstellungen, wenn Ihre Datei direkt mit Daten beginnt.
- 3
Umwandeln und einfügen
Klicken Sie auf In Markdown-Tabelle umwandeln, öffnen Sie die .md-Datei und fügen Sie die Tabelle in Ihre README, Pull Request, Issue oder Notiz ein.
Wie wandle ich eine CSV-Datei in eine Markdown-Tabelle um?
Laden Sie die CSV-Datei hoch und klicken Sie auf In Markdown-Tabelle umwandeln. Die erste Zeile wird zur Tabellenkopfzeile, darunter wird eine Zeile aus Strichen eingefügt, und jede weitere Zeile wird zu einer Tabellenzeile mit durch senkrechte Striche getrennten Zellen.
Warum Entwickler CSV in Markdown umwandeln
Dokumentation landet immer häufiger in Markdown-Dateien. Eine Maintainerin möchte eine Tabelle der unterstützten Versionen in der README, ein Entwickler fügt Benchmark-Werte in einen Pull Request ein, eine Forscherin führt ihre Leseliste in Obsidian. Die Zahlen stammen meist aus einer Tabellenkalkulation oder der CSV-Ausgabe eines Skripts, und sie von Hand mit einem senkrechten Strich zwischen jeder Zelle nachzubauen ist langsam und fehleranfällig.
Das ursprüngliche Markdown von John Gruber aus dem Jahr 2004 kannte überhaupt keine Tabellen. Die Pipe-Syntax verbreitete sich über PHP Markdown Extra und wurde 2017 in die Spezifikation von GitHub Flavored Markdown aufgenommen, weshalb sie auf GitHub und in den meisten Tools funktioniert, die dieser folgen. Stammen die Zeilen aus Excel, speichern Sie sie zuerst mit Excel in CSV und wandeln Sie sie dann hier um.
Beispiel: CSV in Markdown-Tabelle
laufzeit,version,status Python,3.13,unterstützt Python,3.9,Supportende | Oktober 2025 Node.js,22,unterstützt
| laufzeit | version | status | | --- | --- | --- | | Python | 3.13 | unterstützt | | Python | 3.9 | Supportende \| Oktober 2025 | | Node.js | 22 | unterstützt |
Wo eine umgewandelte Markdown-Tabelle angezeigt wird
| Organisation | Anforderung | Quelle |
|---|---|---|
| GitHub | Stellt Pipe-Tabellen in READMEs, Issues, Pull Requests und Wikis dar und folgt dabei der GFM-Spezifikation. | GFM-Spezifikation |
| GitLab | GitLab Flavored Markdown stellt dieselben Pipe-Tabellen in Repositories, Issues und Merge Requests dar. | — |
| Obsidian | Zeigt Pipe-Tabellen in der Leseansicht an und bietet in der Live-Vorschau eine Tabellenbearbeitung. | — |
| Jupyter | Markdown-Zellen in Notebooks stellen Pipe-Tabellen neben Ihrem Code dar. | — |
| CommonMark | Die Kernspezifikation enthält keine Tabellensyntax; Renderer benötigen eine Tabellenerweiterung. | commonmark.org |
Fakten zu CSV und Markdown
CSV
Kommagetrennte Werte
CSV ist ein Nur-Text-Format für Tabellen, bei dem jede Zeile eine Datenzeile ist und Kommas die Spalten trennen. Es wird seit den Anfängen der Computertechnik genutzt und ist in RFC 4180 beschrieben, wobei viele Varianten Semikolons oder Tabulatoren und andere Zeichenkodierungen verwenden. Fast jede Tabellenkalkulation, Datenbank und Analyse-Software kann es importieren und exportieren, daher ist es das Standardformat für den Datenaustausch zwischen Systemen. CSV speichert nur Werte, ohne Formeln, Formatierung, mehrere Tabellenblätter oder Datentypen.
- Komprimierung
- –
- Transparenz
- –
- Animation
- –
- Eingeführt
- –
MD
Markdown
Markdown ist eine schlanke Auszeichnungssyntax, die John Gruber 2004 entwickelt hat. Sie nutzt Klartextzeichen wie # für Überschriften, * für Hervorhebung und - für Listen, die als Rohtext lesbar bleiben und sich sauber in HTML umwandeln lassen. Sie ist der Standard für README-Dateien, Dokumentation, Wikis, Notiz-Apps und viele Generatoren für statische Websites. Es gibt mehrere Dialekte wie CommonMark und GitHub Flavored Markdown, die sich in Details wie Tabellen unterscheiden. Jeder Texteditor kann .md-Dateien öffnen.
- Komprimierung
- –
- Transparenz
- –
- Animation
- –
- Eingeführt
- 2004 · John Gruber
CSV wird zu Markdown, wenn ein kleiner Datensatz in eine Dokumentation gehört: die Kompatibilitätstabelle einer README, die Versionsliste eines Changelogs, ein Pull Request mit dem Vergleich von Benchmark-Läufen oder eine Notiz in einer persönlichen Wissenssammlung.
Die Umwandlung ist bei den Werten nahezu verlustfrei, bei der Bedeutung jedoch nicht. Eine CSV-Datei hält jede Zeile für Software lesbar fest; eine Markdown-Tabelle ist ein Abbild der Daten für Menschen und kennt weder Datentypen noch Formeln noch verbundene Zellen. Behalten Sie die CSV-Datei als Quelle im Repository und erzeugen Sie die Tabelle neu, wenn sich die Zahlen ändern.
Häufige Fragen zu CSV in Markdown
Wo werden Markdown-Tabellen dargestellt?
Überall, wo der Renderer die Pipe-Tabellen-Erweiterung unterstützt: GitHub, GitLab, Obsidian, Jupyter Notebooks sowie statische Seitengeneratoren wie MkDocs und Hugo. Ein streng nach CommonMark arbeitender Renderer zeigt dieselben Zeilen als reinen Text mit sichtbaren senkrechten Strichen an.
Was passiert, wenn ein Wert in meiner CSV einen senkrechten Strich (|) enthält?
Ein nicht maskiertes | würde eine neue Zelle beginnen und jede Spalte nach rechts verschieben. Der Konverter schreibt es als \|, die in GitHub Flavored Markdown definierte Maskierung, sodass der senkrechte Strich als Text in der Zelle erscheint.
Kann ich Zahlen rechtsbündig ausrichten?
Ja, indem Sie die Trennzeile bearbeiten: ---: richtet eine Spalte rechtsbündig aus, :---: zentriert sie und :--- richtet sie linksbündig aus. Ergänzen Sie die Doppelpunkte nach der Umwandlung; sie ändern nur die Darstellung der Tabelle, nicht die Daten.
Wie groß darf eine CSV sein, damit eine Markdown-Tabelle sinnvoll ist?
Markdown-Tabellen sind zum Lesen gedacht, daher funktionieren einige Dutzend Zeilen und eine Handvoll Spalten am besten. Eine Tabelle mit Tausenden Zeilen wird zwar problemlos umgewandelt, macht eine README aber unübersichtlich; verlinken Sie stattdessen die CSV-Datei im Repository und zeigen Sie einen Ausschnitt.
Was passiert mit Zeilenumbrüchen innerhalb eines CSV-Felds?
Eine Zeile einer Markdown-Tabelle muss in einer Zeile bleiben, deshalb kann ein in Anführungszeichen stehender CSV-Wert über mehrere Zeilen nicht unverändert übernommen werden. Ersetzen Sie diese Umbrüche vor der Umwandlung; auf GitHub können Sie in einer Zelle <br> für einen Umbruch verwenden.
Kann ich die Tabelle stattdessen in HTML umwandeln?
Wenn das Ziel eine Webseite, ein CMS oder eine E-Mail statt einer Markdown-Datei ist, stellen Sie Umwandeln in auf HTML-Tabelle. Für Daten, die als JSON vorliegen, hat die Seite JSON in HTML diese Ausgabe bereits voreingestellt.