CSV wirkt einfach, bis ein Wert das Trennzeichen enthält. Das Aufteilen jeder Zeile an Kommas funktioniert für Alice,Active,10, scheitert aber bei "Keyboard, compact" oder "1,999.00". Eine zuverlässige Konvertierung muss zuerst den CSV-Datensatz parsen und danach Markdown erzeugen.
Mit gültigen CSV-Datensätzen beginnen
Ein CSV-Parser behandelt Trennzeichen in Feldern mit Anführungszeichen als Text. Ein Anführungszeichen innerhalb eines solchen Feldes wird verdoppelt:
Product,Description,Price
Keyboard,"Compact, wireless","$89.00"
Monitor,"27"" IPS display","$299.00"Der zweite Datensatz hat drei Zellen, nicht fünf. Prüfen Sie vor großen Dateien Trennzeichen und Zeichenkodierung. Tabellenprogramme exportieren je nach Region Kommas, Tabulatoren oder Semikolons. DevToy erkennt Komma und Tabulator; TSV ist sinnvoll, wenn viele Zellen Kommas enthalten.
Das geparste Raster in Markdown umwandeln
Eine Markdown-Tabelle benötigt eine Kopf- und eine Trennzeile:
| Product | Description | Price |
| :--- | :--- | ---: |
| Keyboard | Compact, wireless | $89.00 |
| Monitor | 27" IPS display | $299.00 |Text und Kennungen werden links, kurze Statuswerte mittig und vergleichbare Zahlen rechts ausgerichtet. Die Ausrichtung ist nur Darstellung und macht aus einer Zeichenfolge keine Zahl.
Markdown-spezifische Zeichen maskieren
CSV-Anführungszeichen und Markdown-Escapes lösen verschiedene Probleme. Ein senkrechter Strich in einer Zelle muss vor der Ausgabe als \| maskiert werden, sonst beginnt eine neue Spalte. Zeilenumbrüche in Zellen werden meist nicht unterstützt. Ersetzen Sie sie durch Leerzeichen oder verwenden Sie <br> nur, wenn Inline-HTML erlaubt ist.
Entfernen Sie Anführungszeichen nicht pauschal. Der Parser entfernt nur Feldbegrenzungen und wandelt verdoppelte Zeichen zurück.
Im Zielsystem prüfen
GitHub, GitLab und Dokumentationsgeneratoren verwenden unterschiedliche Markdown-Dialekte. Testen Sie vor tausenden Zeilen eine kleine Probe auf Spaltenzahl, Pipes, HTML und Unicode.
Für sensible Daten eignet sich der visuelle Markdown-Tabellengenerator. Parsing und Konvertierung laufen vollständig im Browser.