CSV in Markdown-Tabelle
Füge CSV ein oder lade eine Datei hoch und erhalte sofort eine Tabelle im GitHub-Flavored-Markdown. Das Trennzeichen wird automatisch erkannt, Spalten werden aufgefüllt, damit die Tabelle auch im Klartext bündig ist, und du kannst jede Spalte links, zentriert oder rechts ausrichten, während du die gerenderte Vorschau siehst.
Zuletzt aktualisiert:
Anleitung: CSV in Markdown-Tabelle
- Füge deine CSV in das Eingabefeld ein oder lade eine .csv-, .tsv- oder .txt-Datei hoch bzw. ziehe sie hinein. Aus Excel oder Google Sheets kopierte Daten (tabulatorgetrennt) funktionieren ebenfalls.
- Prüfe das Trennzeichen. Es wird automatisch erkannt; wähle es manuell, wenn die Vorschau falsch aussieht.
- Lege Kopfzeile und Ausrichtung fest. Verwende die erste Zeile als Kopfzeile und wähle über der Vorschau für jede Spalte links, zentriert oder rechts.
- Wähle hübsche oder kompakte Ausgabe. Hübsch füllt jede Spalte auf dieselbe Breite auf, damit der Quelltext gut lesbar ist.
- Kopiere oder lade das Markdown herunter und füge es in eine README, ein GitHub-Issue, ein Wiki oder eine Dokumentationsseite ein.
Syntax von Markdown-Tabellen
Eine Tabelle im GitHub-Flavored-Markdown (GFM) besteht aus einer Kopfzeile, einer Trennzeile und beliebig vielen Datenzeilen, wobei die Zellen durch Pipes getrennt sind:
| Tool | Price | Rating |
| :------------- | ----: | :----: |
| Markdown Editor | 0 | 4.8 |
| Team Plan | 12.50 | 4.5 |
Die Doppelpunkte in der Trennzeile legen die Ausrichtung jeder Spalte fest. Die Leerzeichen zum Ausrichten der Spalten sind optional: Renderer ignorieren sie, aber sie machen die Tabelle im Klartext, in Diffs und in Pull Requests viel leichter lesbar und prüfbar.
| Trennzeile | Ausrichtung | Typische Verwendung |
|---|---|---|
--- | Standard (meist links) | Allgemeiner Text |
:--- | Links | Namen, Beschreibungen |
:---: | Zentriert | Kurze Statuswerte, Icons, Bewertungen |
---: | Rechts | Zahlen und Preise, damit die Dezimalstellen untereinander stehen |
Grenzen von Markdown-Tabellen
- Eine Zeile pro Tabellenzeile. Zellen dürfen keine echten Zeilenumbrüche enthalten, daher werden sie als
<br>geschrieben, was GitHub und die meisten Renderer als neue Zeile anzeigen. - Keine verbundenen Zellen. GFM kennt kein colspan oder rowspan. Wiederhole den Wert oder lass Zellen leer.
- Eine Kopfzeile ist Pflicht. Jede GFM-Tabelle braucht eine Kopfzeile; hat deine CSV keine, werden allgemeine Überschriften „Spalte 1, Spalte 2“ hinzugefügt.
- Pipes müssen maskiert werden. Ein wörtliches
|in einer Zelle wird als\|geschrieben. Inline-Markdown wie**bold**,`code`und Links funktioniert in Zellen weiterhin. - Große Tabellen werden unhandlich. Ab einigen Dutzend Zeilen oder sehr breiten Spalten verlinke besser auf die CSV-Datei; GitHub stellt .csv-Dateien selbst als durchsuchbare Tabellen dar.
Häufige Fragen
Wie erstelle ich eine Markdown-Tabelle aus CSV?
Füge die CSV hier ein. Jede CSV-Zeile wird zu einer Tabellenzeile mit durch |-Zeichen getrennten Zellen, und unter der Kopfzeile wird eine Trennzeile wie | --- | --- | eingefügt. Kopiere das Ergebnis in eine beliebige Markdown-Datei, die Tabellen im GitHub-Flavored-Markdown unterstützt.
Wie funktioniert die Spaltenausrichtung in Markdown?
Die Ausrichtung wird in der Trennzeile unter der Kopfzeile festgelegt: :--- richtet links aus, :---: zentriert und ---: richtet rechts aus. Ein einfaches --- nutzt den Standard des Renderers, meist links. Wähle die Ausrichtung pro Spalte mit den Schaltern über der Vorschau.
Was passiert mit Kommas, Anführungszeichen und Pipes in Zellen?
CSV-Felder in Anführungszeichen wie "Smith, John" bleiben in einer Zelle, und verdoppelte Anführungszeichen "" werden zu einem einzelnen. Ein | in einer Zelle würde die Markdown-Tabelle zerstören, daher wird es als \| maskiert. Zeilenumbrüche in einer Zelle werden zu <br>, weil Markdown-Tabellenzellen in einer Zeile stehen müssen.
Kann ich Daten aus Excel oder Google Sheets einfügen?
Ja. Beim Kopieren von Zellen aus einer Tabellenkalkulation landet tabulatorgetrennter Text in der Zwischenablage. Füge ihn ein, und das Tab-Trennzeichen wird automatisch erkannt.
Meine CSV hat keine Kopfzeile. Was soll ich tun?
Deaktiviere „Erste Zeile als Kopfzeile verwenden“. Markdown-Tabellen benötigen eine Kopfzeile, daher fügt das Tool eine allgemeine hinzu (Spalte 1, Spalte 2, ...), die du anschließend bearbeiten kannst.
Welche Seiten stellen diese Tabellen dar?
GitHub, GitLab, Bitbucket, Gitea, Obsidian, der Notion-Import, Docusaurus, MkDocs, Jekyll (kramdown), Hugo und die meisten Markdown-Editoren unterstützen Pipe-Tabellen. Das ursprüngliche Markdown.pl nicht; prüfe also deinen Renderer, wenn er rohe Pipes anzeigt.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.