CSV zu Markdown Konverter

READMEs, Beschreibungen von Pull-Requests und Dokumentationsseiten stellen Markdown-Tabellen wunderschön dar, sofern du dir die Mühe machst, die Pipes und Striche von Hand zu schreiben. Dieser Konverter liest eine CSV, nimmt die erste Zeile als Header und gibt eine GitHub Flavored Markdown-Tabelle mit der richtigen Trennerzeile aus. Jede Zelle ist von |-Trennzeichen umgeben, bereit zum Einfügen in ein README oder eine Pull-Request-Beschreibung.

Wie die Tabelle erstellt wird

  1. 1

    Füge die CSV ein

    Standardmäßig ein Beispiel mit drei Spalten; tausche es gegen deine eigenen Daten aus.

  2. 2

    Wähle das Trennzeichen

    Standardmäßig Komma. Wähle je nach deinen Daten Tab, Semikolon oder Pipe aus der Liste.

  3. 3

    Zeile 1 ist der Header

    Die erste Zeile wird als Markdown-Header ausgegeben, gefolgt von der erforderlichen `| --- | --- |` Trennerzeile.

  4. 4

    Zeilen auf Breite gepolstert

    Wenn eine Datenzeile weniger Zellen als der Header hat, polstert der Konverter mit leeren Zeichenfolgen, um die Tabelle rechteckig zu halten.

Darstellung, Ausrichtung und wo es funktioniert und wo nicht

GitHub Flavored Markdown (GFM) Tabellen werden weitgehend unterstützt, sind aber nicht universell. Zu wissen, wo sie gerendert werden, ist der Unterschied zwischen einem klaren README und einer Wand aus Pipes.

Unterstützt in

  • GitHub, GitLab, Bitbucket Pull-Requests und Wikis
  • Die meisten statischen Site-Generatoren (Docusaurus, VitePress, MkDocs Material)
  • VS Code Markdown-Vorschau
  • Notion (über Einfügen als Markdown)

Nicht unterstützt in

  • CommonMark ohne die GFM-Erweiterung
  • Reddit (verwendet einen eigenen Teilbereich)
  • Einige ältere Wiki-Engines (DokuWiki, MoinMoin)

Spaltenausrichtung

GFM-Tabellen unterstützen links, zentriert und rechts ausgerichtete Spalten über Doppelpunkte in der Trennerzeile. Dieser Konverter gibt einfache --- Trenner aus; wenn du eine Ausrichtung benötigst, bearbeite nach:

Syntax Effekt
:--- Links ausrichten
:---: Zentriert ausrichten
---: Rechts ausrichten

Finde und ersetze die Trennerzeile mit | :--- | :---: | ---: |, um die Spalten zu neigen, die du möchtest.

Zeichen in Markdown-Zellen zitieren

  • Pipe-Zeichen (|) innerhalb einer Zelle müssen als \\| escaped werden, um zu vermeiden, dass die Zelle aufgeteilt wird. Der Konverter escaped sie nicht automatisch, also bereinige vorher, wenn deine Daten Pipes enthalten.
  • Zeilenumbrüche innerhalb einer Zelle brechen die GFM-Darstellung. Ersetze sie durch <br>, bevor du konvertierst, wenn du weiche Zeilenumbrüche innerhalb einer Zelle möchtest.
  • Sterne, Unterstriche und Backticks werden durchgelassen; sie werden als Markdown-Hervorhebung oder Code interpretiert. Escape sie mit einem führenden Backslash, wenn du sie wörtlich haben möchtest.

Häufig gestellte Fragen

Nicht standardmäßig: die Trennerzeile ist einfach ---. Ersetze sie nach der Konvertierung durch :---, :---: oder ---:, um die Spalte links, zentriert oder rechts zu fixieren.

Escape sie mit einem Backslash vor der Konvertierung, indem du | in \| umwandelst. Andernfalls behandelt der Markdown-Renderer sie als Spaltentrenner und bricht die Tabelle.

GFM-Tabellen werden auf GitHub, GitLab, den meisten statischen Site-Generatoren und VS Code gerendert. Sie werden nicht auf einfachem CommonMark, Reddit oder einigen älteren Wikis ohne ein Plugin gerendert.

Ja, die CSV wird an unseren Server gesendet, damit der Konverter die Tabelle erstellen kann. Sie wird nicht gespeichert und nicht zum Seitenlink hinzugefügt.

Verwandte Tools

Tool in anderen Sprachen verfügbar