So verwenden Sie es
- Wählen Sie die Richtung unter Umwandeln: CSV oder TSV in eine Markdown-Tabelle oder eine Markdown-Tabelle in CSV.
- Fügen Sie den Text in Zu wandelnder Text ein. Bei CSV ist die erste Zeile die Kopfzeile der Tabelle.
- Lassen Sie unter Spaltenausrichtung die Einstellung Automatisch, die Zahlen nach rechts setzt, oder wählen Sie für jede Spalte eine Seite.
- Kopieren Sie die Markdown-Tabelle oder das CSV, je nachdem, was die Richtung ergibt.
Die Syntax der Markdown-Tabelle
Eine Tabelle in der Erweiterung für Tabellen von GitHub Flavored Markdown hat eine Kopfzeile, eine Trennzeile und Datenzeilen. Die Zellen stehen zwischen senkrechten Strichen. Die Trennzeile hat für jede Spalte eine Zelle aus Bindestrichen, mit einem optionalen Doppelpunkt an einem der Enden. Die GFM-Spezifikation (englisch) verlangt, dass die Trennzeile so viele Zellen hat wie die Kopfzeile. Ein Doppelpunkt links richtet die Spalte nach links aus, einer rechts nach rechts, und Doppelpunkte auf beiden Seiten zentrieren sie.
Eine Datenzeile mit weniger Zellen als die Kopfzeile bekommt leere Zellen angehängt. Eine Datenzeile mit mehr Zellen hat die zusätzlichen Zellen ignoriert. Ein senkrechter Strich in einer Zelle wird mit einem Backslash davor geschrieben, damit die Darstellung ihn in der Zelle behält.
| Kopf | Kopf | danach | --- | ---: | danach | Daten | Daten |Spaltenbreite, Zahlen und Maskierung
Jede Spalte ist so breit wie ihre breiteste Zelle, mindestens aber drei Zeichen breit, damit jede Zeile einer aufgefüllten Tabelle gleich lang ist. Eine Spalte, in der jede gefüllte Zelle eine Zahl ist, wird nach rechts ausgerichtet, damit sich die Ziffern leicht vergleichen lassen. Die Breite wird in Zeichen gezählt, daher kann ein breiter Buchstabe nicht genau untereinander stehen.
Eine Tabellenzeile muss in einer Zeile stehen. Ein Zeilenumbruch in einer CSV-Zelle wird daher als Leerzeichen geschrieben. Das Lesen von CSV folgt den üblichen Regeln: Eine Zelle, die ein Komma oder ein Anführungszeichen enthält, steht in Anführungszeichen, und ein Anführungszeichen darin wird verdoppelt.
- Wählen Sie das Trennzeichen selbst, wenn Erkennen das falsche wählt. Eine Tabellenkalkulation mit deutschem Dezimalkomma verwendet oft Semikolons.
- Schalten Sie Spalten ausrichten aus, wenn der Markdown-Text lang ist und die Dateigröße wichtiger ist als das Layout des rohen Textes.
Rechenbeispiel: eine Preisliste mit einem Strich in einem Namen
Die CSV hat die Kopfzeile Produkt, Preis, Lager und die Zeilen Tee, 12.5, 40 sowie Kaffee | Bohne, 85, 12. Die Zelle Kaffee | Bohne ist, wenn ihr Strich maskiert ist, 15 Zeichen breit. Daher ist die Spalte Produkt 15 Zeichen breit, und Preis und Lager sind 5 Zeichen breit, weil ihre Zahlen rechts ausgerichtet sind.
Die Trennzeile lautet --------------- für Produkt und ----: für Preis und Lager. Die Zeile von Kaffee lautet Kaffee \| Bohne, danach 85 und 12, nach rechts aufgefüllt. Die Tabelle hat 2 Datenzeilen und 3 Spalten.
Häufig gestellte Fragen
Warum braucht ein Strich in einer Zelle einen Backslash?
Ein senkrechter Strich trennt die Spalten einer Markdown-Tabelle, daher würde ein nackter Strich in einer Zelle eine neue Spalte beginnen. Ein Backslash davor behält den Strich in der Zelle, und die dargestellte Tabelle zeigt einen einzelnen Strich.
Ändern die Leerzeichen für die Ausrichtung das Aussehen der Tabelle?
Nein. Darstellungsprogramme ignorieren die Leerzeichen um den Text einer Zelle, daher sieht die Tabelle gleich aus. Die Auffüllung macht nur den rohen Markdown-Text im Editor leichter lesbar.
Warum werden Zahlenspalten nach rechts ausgerichtet?
Ziffern lassen sich leichter vergleichen, wenn ihre letzten Stellen untereinanderstehen. Daher setzt die automatische Ausrichtung eine Spalte mit Zahlen nach rechts. Eine Spalte mit beliebigem Text bleibt schlicht, also links.
Was geschieht mit einem Zeilenumbruch in einer CSV-Zelle?
Eine Tabellenzeile muss in einer Zeile stehen, daher schreibt der Rechner einen Zeilenumbruch in einer Zelle als Leerzeichen. Der Text der Zelle bleibt bis auf dieses Leerzeichen gleich.
Wo werden Markdown-Tabellen richtig dargestellt?
GitHub und die meisten Markdown-Programme, die der GFM-Erweiterung für Tabellen folgen, stellen sie dar. Manche einfachen Markdown-Darsteller kennen gar keine Tabellensyntax. Prüfen Sie daher den Ort, an dem Sie die Tabelle veröffentlichen.
Wird der eingefügte Text irgendwohin gesendet oder gespeichert?
Nein. Die Tabelle und das CSV entstehen in Ihrem Browser. Nichts wird gespeichert oder an unseren Server gesendet. Kopieren Sie das Ergebnis daher, bevor Sie die Seite verlassen.
Quellen
- GitHub Flavored Markdown Spec (englisch), Erweiterung für Tabellen
- IETF (englisch): RFC 4180, Common Format and MIME Type for CSV Files
Zahlen und Text zuletzt geprüft: Dienstag, 10. November 2026.