Der senkrechte Strich ist Tabellensyntax, kommt aber auch in Shell-Befehlen, TypeScript-Unions, regulären Ausdrücken und Text vor. Ein unmaskiertes | kann als nächste Spaltengrenze interpretiert werden.
Eine literale Pipe maskieren
Setzen Sie unmittelbar davor einen Backslash:
| Ausdruck | Bedeutung |
| :--- | :--- |
| `ready \| waiting` | Beide Zustände sind zulässig |
| `string \| null` | Eine TypeScript-Union |Manche Renderer verarbeiten Code-Spans zuerst, andere verlangen auch innerhalb von Backticks ein Escape. Maskieren ist die portablere Wahl. Ein Generator sollte dies bei der Markdown-Ausgabe tun, nicht den sichtbaren Editorwert verändern.
Backslash-Eingaben richtig behandeln
Enthält der Rohwert bereits \|, kann ein naiver Formatierer bei jedem Lauf einen weiteren Backslash hinzufügen. Trennen Sie den editierbaren Rasterwert von der serialisierten Markdown-Ausgabe und maskieren Sie genau einmal beim Export. Beim Import werden Escapes dekodiert und beim Export wieder kodiert.
Zeilenumbrüche bewusst behandeln
Die meisten Implementierungen erwarten eine Quellzeile pro Tabellenzeile. Praktische Optionen sind:
- Den Umbruch durch ein Leerzeichen ersetzen.
<br>verwenden, wenn Inline-HTML erlaubt ist.- Details unter die Tabelle verschieben und aus einer kurzen Zelle verlinken.
Die dritte Variante ist oft zugänglicher und auf Mobilgeräten besser lesbar.
Den Ziel-Renderer testen
GitHub, statische Generatoren und interne Portale können denselben Quelltext unterschiedlich darstellen. Bewahren Sie eine minimale Testtabelle auf, wenn Pipes und Inline-Code zentral sind.
Der visuelle Tabellengenerator maskiert Pipes bei der Ausgabe, ohne Zellinhalte an einen Server zu senden.