Markdown-Tabelle ausrichten: Der Doppelpunkt in der Trennzeile

Inhalt
Sie haben eine Markdown-Tabelle von Hand geschrieben, wollten einen Text zentrieren und konnten die Leertaste drücken, so oft Sie wollten – es hat nichts bewirkt. Die Ausrichtung einer Markdown-Tabelle wird nämlich nicht durch Leerzeichen bestimmt, sondern an ganz anderer Stelle.
Kurzfassung ① Die Ausrichtung einer Markdown-Tabelle bestimmen nicht die Leerzeichen in den Zellen, sondern die Doppelpunkte (:) in der Trennzeile direkt unter der Kopfzeile. ②
:---steht für linksbündig,:---:für zentriert und---:für rechtsbündig. Das ist eine feste Konvention. ③ Fehlt diese Trennzeile oder stimmt ihr Format nicht, wird der tabellenähnliche Text unter Umständen nicht als Tabelle erkannt und erscheint einfach als normaler Text.
Die zweite Zeile macht aus Text eine Tabelle
In Markdown besteht eine Tabelle aus mindestens zwei Zeilen. Die erste Zeile ist die Kopfzeile, deren Zellen durch senkrechte Striche (|) getrennt sind. Direkt darunter folgt die Trennzeile, die ausschließlich aus Bindestrichen (-) besteht. Erst durch diese Trennzeile erkennt der Markdown-Renderer: „Das ist eine Tabelle“, und behandelt die Zeile darüber als Kopfzeile.
Das Problem: Die Trennzeile enthält zugleich die Angaben zur Ausrichtung. Optisch ist sie nur eine Reihe von Bindestrichen. Ob vor oder hinter den Bindestrichen ein Doppelpunkt steht, entscheidet jedoch darüber, wie die jeweilige Spalte ausgerichtet wird.
Die Position des Doppelpunkts bestimmt die Ausrichtung
Je nachdem, wo in der Trennzeile der Doppelpunkt steht, ergibt sich eine von drei Ausrichtungen: :--- mit Doppelpunkt nur links ist linksbündig, :---: mit Doppelpunkten auf beiden Seiten ist zentriert, und ---: mit Doppelpunkt nur rechts ist rechtsbündig. Ohne Doppelpunkt (---) gilt der Standardwert des Renderers, in der Regel linksbündig.
Wie viele Leerzeichen Sie in einer Zelle auch einfügen, um den Text in die Mitte zu schieben: Auf das gerenderte Ergebnis hat das keinen Einfluss. Der Markdown-Renderer ignoriert führende und nachfolgende Leerzeichen in der Zelle und berechnet die Ausrichtung allein anhand der Doppelpunkte in der Trennzeile.
Zeilen, Spalten und Ausrichtung festlegen und sofort die passende Markdown-Tabellensyntax erzeugen – mit dem Markdown-Tabellen-Generator

Was passiert, wenn das Format der Trennzeile nicht stimmt
Stimmt die Zahl der Spalten in der Trennzeile nicht mit der Kopfzeile überein oder stehen darin andere Zeichen als Bindestriche, erkennt der Markdown-Renderer den gesamten Text unter Umständen nicht als Tabelle. In diesem Fall werden die senkrechten Striche und Bindestriche, die eigentlich eine Tabelle bilden sollten, einfach als Text ausgegeben. Statt der gewünschten Tabelle bleibt dann nur eine schwer lesbare Folge von Zeichen übrig.
So übernimmt das Tool die Syntax für Sie
Im Markdown-Tabellen-Generator legen Sie die Anzahl der Zeilen und Spalten fest und tragen den Inhalt in die Zellen ein. Daraus setzt das Tool automatisch Kopfzeile, Trennzeile mit den Ausrichtungsangaben und Tabellenkörper in korrekter Syntax zusammen. Für jede Spalte können Sie links-, mittig oder rechtsbündig wählen; sobald Sie die Auswahl ändern, zeigt das Ergebnis in Echtzeit die geänderte Position der Doppelpunkte in der Trennzeile. Auch wenn Sie in einer Zelle Zeichen eingeben, die mit der Tabellensyntax kollidieren – etwa einen senkrechten Strich (|) oder einen Zeilenumbruch –, werden diese automatisch maskiert (Escaping), sodass die Tabelle nicht auseinanderbricht.
Zusammenfassung
- Die Ausrichtung einer Markdown-Tabelle bestimmen nicht die Leerzeichen in den Zellen, sondern die Doppelpunkte in der Trennzeile unter der Kopfzeile.
- Mit den drei Schreibweisen
:---(linksbündig),:---:(zentriert) und---:(rechtsbündig) lässt sich jede Spalte unterschiedlich ausrichten. - Stimmt die Spaltenzahl der Trennzeile nicht mit der Kopfzeile überein oder ist das Format fehlerhaft, wird die Tabelle unter Umständen insgesamt nicht erkannt.
- Senkrechte Striche oder Zeilenumbrüche in einer Zelle kollidieren mit der Tabellensyntax und müssen maskiert werden.
- Der Markdown-Tabellen-Generator übernimmt die Auswahl der Ausrichtung und das Maskieren von Sonderzeichen automatisch und erzeugt so eine Tabelle mit korrekter Syntax.
Zeilen, Spalten und Ausrichtung festlegen und sofort die passende Markdown-Tabellensyntax erzeugen – mit dem Markdown-Tabellen-Generator
Häufige Fragen
Wird ein Text zentriert, wenn ich ihn in der Zelle mit Leerzeichen in die Mitte schiebe?
Nein. Der Markdown-Renderer ignoriert führende und nachfolgende Leerzeichen in der Zelle und berechnet die Ausrichtung allein anhand der Doppelpunkte in der Trennzeile. Wenn Sie zentrieren möchten, muss die Trennzeile im Format :---: geschrieben sein.
Was passiert, wenn ich keine Ausrichtung angebe?
Steht in der Trennzeile nur --- ohne Doppelpunkt, gibt es keine Angabe zur Ausrichtung. Dann gilt die Standardausrichtung des Renderers, der die Tabelle anzeigt (meist linksbündig).
Ich habe senkrechte Striche wie in einer Tabelle gesetzt, aber es wird keine Tabelle angezeigt. Woran liegt das?
Die häufigste Ursache ist, dass direkt unter der Kopfzeile die Trennzeile aus Bindestrichen fehlt oder dass die Spaltenzahl der Trennzeile nicht zur Kopfzeile passt. Ohne Trennzeile erkennt der Renderer keine Tabelle und zeigt die eingegebenen senkrechten Striche und den Text unverändert als normalen Text an.
Wie füge ich einen senkrechten Strich (|) als Zeichen in eine Zelle ein?
Der senkrechte Strich ist das Trennzeichen zwischen den Spalten. Wenn Sie ihn einfach so einfügen, wird er leicht als Beginn einer neuen Zelle missverstanden. Mit dem Markdown-Tabellen-Generator wird ein in die Zelle eingegebener senkrechter Strich automatisch maskiert, sodass die Tabelle nicht auseinanderbricht.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen