Direkt zum Tool
ViewCSV
Kein Datei-Upload

CSV in eine Markdown-Tabelle umwandeln

orders.csv· BEISPIELDATEN15 Zeilen · 8 Spalten
Verhindert, dass * _ ` [ ] < > # ~ in Ihren Daten als Formatierung wirken.
| order\_id | customer       | city              | product          | quantity | unit\_price | order\_date | status   |
| --------- | -------------- | ----------------- | ---------------- | -------: | ----------: | ----------- | -------- |
| 001041    | Laura Koch     | Leipzig           | Monitor 27"      |        4 |      180.60 | 2026-01-15  | shipped  |
| 001042    | Mia Müller     | Köln              | Coffee beans 1kg |        3 |      156.81 | 2026-02-26  | refunded |
| 001043    | Anna Fischer   | Leipzig           | Notebook A5      |        1 |      229.89 | 2026-03-17  | refunded |
| 001044    | Jonas Wagner   | Berlin            | Notebook A5      |        9 |       80.03 | 2026-04-23  | paid     |
| 001045    | Anna Koch      | Dresden           | Monitor 27"      |        5 |             | 2026-05-24  | pending  |
| 001046    | Felix Becker   | Frankfurt am Main | Coffee beans 1kg |        5 |       93.26 | 2026-06-08  | refunded |
| 001047    |  Lena Koch     | München           | Coffee beans 1kg |        3 |      102.06 | 2026-07-26  | pending  |
| 001048    | Sophie Schmidt | Frankfurt am Main | Desk lamp        |        1 |      215.25 | 2026-08-03  | paid     |
| 001049    | Leon Müller    | Frankfurt am Main | USB-C cable      |        6 |       89.20 | 2026-09-03  | paid     |
| 001050    | Leon Meyer     | Berlin            | Notebook A5      |        1 |      101.11 | 2026-01-10  | refunded |
| 001051    | Leon Bauer     | Frankfurt am Main | Notebook A5      |        9 |      142.33 | 2026-02-01  | refunded |
| 001052    | Felix Schäfer  | Hamburg           | Monitor 27"      |        4 |      161.36 | 2026-03-24  | shipped  |
| 001053    | Max Wagner     | Hamburg           | Monitor 27"      |        1 |      184.33 | 2026-04-13  | paid     |
| 001054    | Jonas Müller   | Hamburg           | Desk lamp        |        8 |      205.98 | 2026-05-06  | pending  |
| 001043    | Anna Fischer   | Leipzig           | Notebook A5      |        1 |      229.89 | 2026-03-17  | refunded |

15 Zeilen · 1 Datei

Öffnen Sie eine CSV-Datei oder fügen Sie sie ein – neben den Optionen erscheint eine Pipe-Tabelle, bereit für eine README-Datei, ein Issue oder eine Wiki-Seite. Ein | in einem Wert wird als \| geschrieben und kann so nie eine Zelle teilen, Zeilenumbrüche in einer Zelle werden zu <br>, und Zahlenspalten werden rechtsbündig ausgerichtet. Die Datei wird in Ihrem Browser umgewandelt und nie hochgeladen.

So wandeln Sie CSV in Markdown um

  1. Wählen Sie Datei öffnen, ziehen Sie eine .csv-, .tsv- oder .txt-Datei auf das Werkzeug, oder wählen Sie Einfügen. Das Trennzeichen wird erkannt; liegt die Erkennung falsch, stellen Sie Trennzeichen, Codierung oder Erste Zeile enthält Spaltenüberschriften unter Importeinstellungen ein.
  2. Wählen Sie die Spaltenausrichtung und wie Zeilenumbrüche in Zellen geschrieben werden. Der Markdown-Tab zeigt genau den Text, den der Download enthalten wird.
  3. Wählen Sie Kopieren, um die Tabelle direkt in GitHub, GitLab oder Ihren Editor einzufügen, oder „Markdown herunterladen“, um eine .md-Datei zu speichern.

Hat Ihre Datei keine Kopfzeile, schalten Sie Erste Zeile enthält Spaltenüberschriften aus: Markdown-Tabellen brauchen immer eine Kopfzeile, daher heißen die Spalten dann Column 1, Column 2 und so weiter. Um dieselben Daten stattdessen als Webtabelle darzustellen, nutzen Sie CSV in HTML.

Optionen für die Markdown-Tabelle

Zahlen rechts, Text standardDie Standardeinstellung. Eine Spalte wird nur dann rechtsbündig (---:), wenn jeder nicht leere Wert eine einfache Zahl ist; bei 00731 oder 12 kg behält die Spalte die Standardausrichtung des Renderers.
Standard (keine), Links, Zentriert, RechtsEine Ausrichtung für alle Spalten: schlicht ---, :---, :---: oder ---: in der Trennzeile.
Als <br> behaltenEin Zeilenumbruch in einer Zelle wird zu <br>, was GitHub und die meisten Renderer als neue Zeile innerhalb der Zelle anzeigen. Das ist die Standardeinstellung.
Durch Leerzeichen ersetzenJeder Zeilenumbruch wird zu einem Leerzeichen – für Renderer, die HTML entfernen.
Markdown-Zeichen maskierenStandardmäßig an. *, _, [, ], <, >, #, ~ und der Backtick erhalten einen Backslash, damit ein Wert wie *fast* oder <b> so erscheint, wie er geschrieben ist, statt zu Formatierung oder HTML zu werden. Schalten Sie die Option nur aus, wenn die Zellen Markdown enthalten, das dargestellt werden soll.
Spalten im Quelltext bündig ausrichtenStandardmäßig an. Füllt Zellen mit Leerzeichen auf, sodass sich die rohe .md-Datei wie ein Raster liest. Breite Zeichen wie Chinesisch, Japanisch oder Koreanisch zählen als zwei Spalten. Ausschalten ergibt die kleinste Ausgabe; die dargestellte Tabelle sieht gleich aus.

Pipes, Zeilenumbrüche und führende Nullen

  • Pipes und Backslashes werden immer maskiert (\|, \\), auch wenn Markdown-Zeichen maskieren aus ist, denn ein unmaskiertes | würde eine neue Zelle beginnen.
  • Kommas und Zeilenumbrüche in Anführungszeichen werden nach RFC 4180 gelesen, sodass "Cable tidy, 3-pack" in einer Zelle bleibt. Jeder Wert, der einen Zeilenumbruch enthielt, wird in einem Hinweis über der Vorschau gezählt.
  • Werte werden als Text geschrieben: 00731 behält seine Nullen und 34.90 seine abschließende Null. Nichts wird gerundet oder umformatiert.
  • Eine leere Spaltenüberschrift wird zu Column 3, eine doppelte zu name (2) – so hat jede Spalte eine eigene Überschrift.
  • Markdown-Renderer entfernen Leerzeichen am Anfang und Ende einer Zelle, und eine Tabelle kann keine Listen oder Absätze enthalten; solche Inhalte gehören in ein eigenes Dokument.

Wenn die Markdown-Tabelle falsch dargestellt wird

  • Text nach der Tabelle hängt an ihrer letzten Zeile. Eine Tabelle endet erst an einer Leerzeile oder am Beginn eines anderen Blocks. Lassen Sie danach also eine Zeile frei.
  • Alle Werte stehen in einer Spalte. Das Trennzeichen wurde falsch erkannt. Stellen Sie unter Importeinstellungen Komma, Semikolon, Tabstopp oder senkrechten Strich ein und öffnen Sie die Datei erneut.
  • **Im Ergebnis stehen Backslashes vor * oder _. Das ist die Maskierung in einem Renderer, der sie nicht auswertet. Schalten Sie Markdown-Zeichen maskieren** aus, wenn Ihre Daten keine Formatierungszeichen enthalten, die geschützt werden müssen.
  • Zeilenumbrüche erscheinen als sichtbares Tag. Der Renderer erlaubt kein HTML. Wählen Sie unter Zeilenumbrüche in Zellen die Option „Durch Leerzeichen ersetzen“.

Grenzen und Datenschutz

Dateien bis 25 MB, 100.000 Zeilen oder 2 Millionen Zellen öffnen mit Live-Vorschau der ersten 200 Zeilen. Größere Dateien werden als Datenstrom umgewandelt: Die Datei wird zweimal abschnittsweise gelesen (einmal, um die Spalten und ihre Breiten zu messen, einmal zum Schreiben), ein Hinweis besagt, dass der Download die ganze Datei umfasst, und Kopieren wird nicht angeboten. Eine einzelne Ausgabedatei ist auf 4 GB begrenzt.

Die Umwandlung läuft in einem Hintergrund-Worker in diesem Tab; die Seite bleibt bedienbar, und Abbrechen beendet den Vorgang. Die CSV-Datei wird nie an einen Server gesendet. Um eine große Datei vor der Umwandlung zu prüfen, öffnen Sie sie im CSV-Viewer.

Beispiel: eine Produktliste als Markdown-Tabelle

Eine Produktliste mit einer SKU mit führender Null, einer Pipe in einem Namen, einem Komma in Anführungszeichen und einer zweizeiligen Notiz, umgewandelt mit den Standardeinstellungen. price ist rechtsbündig, weil jeder Wert eine Zahl ist; sku nicht, weil 00731 als Text erhalten bleibt.

CSV
sku,name,price,note
00731,"Desk lamp | brass",34.90,"Ships in 2 days
from Leeds"
00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025
00733,USB-C hub,129.00,
Markdown-Ausgabe
| sku   | name                     |  price | note                             |
| ----- | ------------------------ | -----: | -------------------------------- |
| 00731 | Desk lamp \| brass       |  34.90 | Ships in 2 days<br>from Leeds    |
| 00732 | Cable tidy, 3-pack white |   4.50 | Back-ordered until 14 March 2025 |
| 00733 | USB-C hub                | 129.00 |                                  |

Fragen und Antworten

Funktioniert die Ausgabe auf GitHub?

Ja. Es ist eine Pipe-Tabelle nach GitHub Flavored Markdown: eine Kopfzeile, eine Trennzeile mit optionalen Doppelpunkten für die Ausrichtung und eine Zeile pro CSV-Zeile. GitLab, Obsidian und die meisten Generatoren für statische Websites lesen dieselbe Syntax.

Warum sehe ich `\|` im Quelltext?

Ein einfaches | beendet in einer Markdown-Tabelle eine Zelle. Der Backslash weist den Renderer an, die Pipe als Text anzuzeigen, sodass Desk lamp | brass in einer Zelle bleibt.

Kann ich eine Markdown-Tabelle zurück in CSV umwandeln?

Nicht auf dieser Seite. Sie wandelt nur CSV und TSV in Markdown um.

Standards und Quellen