Um mehrere Zeilen in einer Markdown-Tabellenzelle anzuzeigen, lassen Sie die Zeile in der Quelldatei auf einer Zeile und fügen Sie zwischen den Textteilen <br> ein. Das funktioniert dort, wo Tabellen und Inline-HTML unterstützt werden. Prüfen Sie Obsidian und den Renderer am Zielort, bevor Sie sich darauf verlassen.

Dieser Leitfaden behandelt eine praktische Aufgabe auf dem Mac-Desktop: eine kleine Tabelle in Obsidian schreiben, ihre Darstellung prüfen und denselben Markdown-Text für GitHub oder einen anderen Renderer vorbereiten. Die Beispiele verwenden fiktive Beschreibungen von Schreibwaren. Die Kompatibilitätsprüfungen unten sind ein aus der Dokumentation abgeleiteter Arbeitsablauf und keine Ergebnisse von Tests installierter Anwendungen.

Welche Markdown-Renderer unterstützen mehrzeilige Tabellenzellen?

Pipe-Tabellen sind eine Erweiterung und kein Bestandteil des CommonMark-Kerns. GitHub Flavored Markdown (GFM) ergänzt Tabellen, deren Zellen Inline-Inhalte akzeptieren. Die Spezifikation schließt Blockelemente innerhalb dieser Zellen aus. Daher ist eine Zelle mit mehreren angezeigten Zeilen etwas anderes als eine Zelle mit separaten Absätzen, einer Markdown-Liste oder einem eingerückten Codeblock. Siehe die GFM-Tabellenspezifikation.

Obsidian dokumentiert Pipe-Tabellen und Formatierungen innerhalb von Zellen. In der Dokumentation zur grundlegenden Syntax wird <br> außerdem als Zeilenumbruch-Tag aufgeführt. Zusammen bilden diese Angaben die dokumentierte Grundlage für die hier verwendete Methode, auch wenn die Tabellenseite kein eigenes Beispiel für mehrzeilige Zellen enthält. Siehe Erweiterte Formatierungssyntax und Grundlegende Formatierungssyntax.

Nutzen Sie diese Entscheidungstabelle, bevor Sie ein großes Dokument bearbeiten:

Zielort Dokumentierte Einschränkung Praktische Wahl
CommonMark-Kern ohne Erweiterungen Pipe-Tabellen gehören nicht zur Kernspezifikation Überschriften und Listen verwenden
GFM-kompatibler Renderer Tabellen akzeptieren Inline-Inhalte, aber keine Blockelemente in Zellen Einen Inline-Umbruch ausprobieren und am Zielort prüfen
Obsidian Tabellen und das Zeilenumbruch-Tag sind dokumentiert Quelle bearbeiten und anschließend die Leseansicht prüfen
Renderer mit unbekannter HTML-Verarbeitung Seine Unterstützung wurde nicht nachgewiesen Vor der Formatwahl den unten stehenden kleinen Vergleich durchführen

Die ersten drei Zeilen stützen sich auf die oben verlinkte CommonMark-Spezifikation, die GFM-Spezifikation und die Obsidian-Dokumentation. Die letzte Zeile empfiehlt eine Überprüfung: Der Name eines Renderers allein belegt nicht, wie er Ihr Dokument verarbeitet.

Wie schreibt man zwei Zeilen in eine Zelle?

Kopieren Sie das folgende Beispiel in eine Notiz, ohne den umgebenden Codeblock zu kopieren. Jede Tabellenzeile steht in der Quelle in einer physischen Zeile; das Umbruchzeichen steht zwischen den beiden Textteilen in der zweiten Zelle.

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |
| Pencil | Graphite core<br>Hexagonal shape |

Das erwartete Ergebnis ist eine zweispaltige Tabelle mit zwei Datenzeilen. In der ersten Detailzelle steht „Gepunktete Seiten“ über „Blauer Einband“. In der zweiten steht „Graphitmine“ über „Sechseckige Form“. Dies ist eine erwartete Darstellung, die überprüft werden sollte, und keine eingebettete Demonstration des Verhaltens Ihres Zielorts.

Die Methode kombiniert einen HTML-Zeilenumbruch mit Tabellensyntax. GitHub nennt ein HTML-Zeilenumbruch-Tag als eine der unterstützten Möglichkeiten für Zeilenumbrüche, und Obsidian dokumentiert <br> ausdrücklich. Diese Markdown-Zellen verwenden also HTML; ihre Portabilität hängt davon ab, ob der Zielort dieses Markup akzeptiert. Siehe die Dokumentation zu Zeilenumbrüchen von GitHub und die Dokumentation zur grundlegenden Syntax von Obsidian.

Halten Sie die Tabellenstruktur einfach: Setzen Sie eine Leerzeile davor, verwenden Sie gleich viele Spalten in Kopf- und Trennzeile und mindestens drei Bindestriche pro Trennzelle. GitHubs Tabellenleitfaden dokumentiert die Leerzeile und die Konvention mit drei Bindestrichen. Obsidian akzeptiert mindestens zwei Bindestriche, daher sind drei eine sinnvolle gemeinsame Wahl. Quellen: Informationen mit Tabellen organisieren und Erweiterte Formatierungssyntax.

Warum helfen Enter, zwei Leerzeichen oder ein Backslash hier nicht?

CommonMark unterstützt harte Zeilenumbrüche mit zwei abschließenden Leerzeichen oder einem Backslash vor einem Zeilenumbruch in der Quelle. Diese Regeln gelten für Inline-Inhalte innerhalb eines bestehenden Blocks; sie definieren keine mehrzeiligen Pipe-Tabellenzellen. Siehe die harten Zeilenumbrüche in CommonMark.

Dieses Beispiel eignet sich bewusst nicht dafür, beide Textteile in einer einzigen GFM-Zelle zu halten:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages
Blue cover |

Nach den Tabellenregeln von GFM ist die zweite Quellzeile eine weitere Zeile und keine Fortsetzung der Detailzelle. Eine Leerzeile würde die Tabelle beenden. Lassen Sie die vollständige Zeile zusammen und setzen Sie den Inline-Umbruch dort, wo sich die angezeigte Zeile ändern soll. Siehe die GFM-Tabellenbeispiele.

Unterscheiden Sie außerdem zwischen automatischem Zeilenumbruch und einem gezielten Umbruch. Für diese Aufgabe ist das Ergebnis dann erfolgreich, wenn der zweite Textteil in einer neuen Zeile beginnt, selbst wenn das Fenster breit genug wäre, um beide Textteile aufzunehmen. Ein Screenshot bei schmalem Fenster allein würde das nicht belegen.

Wie prüft man die Tabelle in Obsidian auf einem Mac?

Verwenden Sie eine temporäre Notiz, die nur die Beispieltabelle enthält. So lässt sich leichter erkennen, ob ein Problem von der Tabelle selbst oder ihrem umgebenden Inhalt stammt.

  1. Wechseln Sie über die Statussteuerung für den Bearbeitungsmodus zu Source mode. In diesem Modus wird der Markdown-Text genau so angezeigt, wie er geschrieben wurde.
  2. Fügen Sie das Beispiel ein und prüfen Sie, ob jede Datenzeile in der Quelle in einer Zeile bleibt.
  3. Drücken Sie Cmd+E, um zwischen Bearbeitung und Reading view zu wechseln.
  4. Prüfen Sie beide Detailzellen: Jede sollte zwei angezeigte Zeilen enthalten, und kein Textteil sollte in eine neue Tabellenzeile gerutscht sein.
  5. Wechseln Sie zurück zur Bearbeitung und vergleichen Sie das Ergebnis auch in Live Preview.

Obsidian dokumentiert Source mode, Live Preview und den Mac-Kurzbefehl unter Ansichten und Bearbeitungsmodus. Live Preview blendet während der Bearbeitung einen Großteil der Syntax aus; Reading view bietet eine separate, hilfreiche Prüfung der formatierten Notiz.

Für einen direkten Vergleich können Sie beim Klicken auf den Ansichtsumschalter Cmd gedrückt halten, um Bearbeitungs- und Leseansicht nebeneinander zu öffnen. Falls diese Steuerung ausgeblendet ist, dokumentiert Obsidian Settings → Appearance → Show tab title bar sowie eine alternative Steuerung in der Statusleiste unter Settings → Editor → Show editing mode in status bar. Siehe Ansichten und Bearbeitungsmodus.

In Obsidians Leitfaden zur grundlegenden Syntax wird Shift+Enter für Zeilenumbrüche in Absätzen und die Einstellung Strict Line Breaks beschrieben. Diese allgemeinen Hinweise zu Absätzen belegen keinen portablen Tastaturkurzbefehl für Tabellenzellen. Prüfen Sie für diesen Test die gespeicherte Zeile im Source mode und verwenden Sie das ausdrückliche Umbruchzeichen, statt die Einstellung als Lösung für Tabellenkompatibilität zu betrachten. Siehe Grundlegende Formatierungssyntax.

Wie lassen sich Unterschiede zwischen Renderern schnell diagnostizieren?

Verwenden Sie neben der vorgeschlagenen mehrzeiligen Version eine einfache Textvariante als Kontrolle. Im folgenden vollständigen Testdokument wird nur das Umbruchzeichen geändert. So lässt sich die Tabellenunterstützung leichter von der Unterstützung für Inline-HTML unterscheiden:

Control:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages; blue cover |

Multiline candidate:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |

Öffnen Sie denselben Inhalt an jedem vorgesehenen Zielort. Bei einer GitHub-Markdown-Datei prüfen Sie die gerenderte Dateiansicht; eine Obsidian-Vorschau bestätigt nur das Ergebnis in Obsidian. GitHub dokumentiert außerdem unterschiedliche Verhalten bei Zeilenumbrüchen in gewöhnlichen Absätzen in Markdown-Dateien und Unterhaltungsfeldern. Das unterstreicht, wie wichtig die Prüfung am tatsächlichen Zielort ist. Siehe Grundlegende Syntax für Schreiben und Formatieren.

Nutzen Sie diese Beobachtungen, um den nächsten Prüfschritt zu bestimmen:

Beobachtung Nächste Prüfung
Beide Beispiele werden als durch senkrechte Striche getrennte Textzeilen angezeigt Tabellenunterstützung bestätigen und prüfen, ob der Inhalt außerhalb eines Codeblocks steht
Die Kontrollvariante funktioniert, aber der Kandidat gibt das Tag als Text aus Prüfen, ob das Tag in Backticks steht oder maskiert wurde
Die Kontrollvariante funktioniert, aber beim Kandidaten fehlt der Umbruch Die Dokumentation des Zielorts zu Inline-HTML prüfen
Der Kandidat erzeugt eine zusätzliche Zeile In der Quelle nach einem tatsächlichen Zeilenumbruch innerhalb der betreffenden Zeile suchen
Ein Textteil verschwindet oder wechselt die Spalte Nach einem nicht maskierten senkrechten Strich im Zelleninhalt suchen

Dies sind diagnostische Möglichkeiten und keine eindeutigen Erklärungen für jeden Renderer. Beheben Sie zuerst das kleinste Beispiel und fügen Sie dann den Rest der Tabelle wieder hinzu. Für wörtliche senkrechte Striche im Zellentext dokumentiert GitHub das Maskieren mit einem Backslash, zum Beispiel Dotted \| plain. Siehe Inhalte in der Tabelle formatieren.

Was verwendet man, wenn mehrzeilige Zellen nicht unterstützt werden?

Wenn der Zielort Tabellen akzeptiert, Inline-HTML jedoch ablehnt, verwenden Sie eine Zeile pro Detail. Durch die Wiederholung des Elementnamens bleibt die Zuordnung erhalten, ohne dass ein Umbruch innerhalb der Zelle nötig ist:

| Item | Detail |
| --- | --- |
| Notebook | Dotted pages |
| Notebook | Blue cover |

Wenn der Zielort nur den CommonMark-Kern unterstützt, verschieben Sie die Details in eine Überschrift und eine Liste:

### Notebook

- Dotted pages
- Blue cover

Überschriften und Listen gehören zur CommonMark-Syntax. Mit dieser Ausweichlösung haben längere Einträge außerdem mehr Platz und sind nicht von einer Tabellenerweiterung abhängig.

Für mehrzeiligen Code setzen Sie einen eingerückten Codeblock außerhalb der Tabelle ein. Mehrere Quellzeilen in einem einzelnen Inline-Code-Span zu umschließen, erhält ihre Zeilenumbrüche nicht: CommonMark normalisiert Zeilenenden in Code-Spans zu Leerzeichen. Siehe Code-Spans.

Wählen Sie das Format danach, welche Inhalte erhalten bleiben sollen. Bei zwei kurzen Textteilen ist ein Inline-Umbruch eine praktische Möglichkeit, die überprüft werden sollte. Bei getrennten Absätzen, umfangreichen Listen oder mehrzeiligem Code verschieben Sie die Details aus der Zelle heraus. Bewahren Sie das kleine Kompatibilitätsbeispiel bei Ihren Arbeitsnotizen auf, damit Sie den Test bei einem Wechsel des Zielorts wiederholen können.

Quellen