Ö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
- 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. - 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.
- 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 standard | Die 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, Rechts | Eine Ausrichtung für alle Spalten: schlicht ---, :---, :---: oder ---: in der Trennzeile. |
| Als <br> behalten | Ein 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 ersetzen | Jeder Zeilenumbruch wird zu einem Leerzeichen – für Renderer, die HTML entfernen. |
| Markdown-Zeichen maskieren | Standardmäß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 ausrichten | Standardmäß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:
00731behält seine Nullen und34.90seine abschließende Null. Nichts wird gerundet oder umformatiert. - Eine leere Spaltenüberschrift wird zu
Column 3, eine doppelte zuname (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.
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,
| 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.