Als je meerdere regels in één Markdown-tabelcel wilt weergeven, houd je de rij op één bronregel en voeg je <br> tussen de zinsdelen in. Dit werkt waar tabellen en inline HTML worden ondersteund; controleer Obsidian en de renderer van je bestemming voordat je erop vertrouwt.

Deze gids behandelt een praktische taak op een Mac-desktop: een kleine tabel schrijven in Obsidian, controleren hoe die eruitziet en dezelfde Markdown voorbereiden voor GitHub of een andere renderer. De voorbeelden gebruiken fictieve beschrijvingen van kantoorartikelen. De compatibiliteitscontroles hieronder zijn een werkwijze op basis van de documentatie, geen testresultaten van geïnstalleerde applicaties.

Welke Markdown-renderers ondersteunen meerdere regels in tabelcellen?

Pipe-tabellen zijn een uitbreiding en maken geen deel uit van de kern van CommonMark. GitHub Flavored Markdown, of GFM, voegt tabellen toe waarvan de cellen inline-inhoud accepteren. De specificatie sluit blokelementen binnen die cellen uit. Een cel met meerdere weergegeven regels verschilt daardoor van een cel met afzonderlijke alinea’s, een Markdown-lijst of een codeblok met hekjes. Zie de GFM-tabelspecificatie.

Obsidian documenteert pipe-tabellen en opmaak binnen cellen. In de documentatie over de basissyntaxis wordt ook <br> genoemd als tag voor een regeleinde. Samen vormen deze de gedocumenteerde basis voor de aanpak in deze gids, hoewel de pagina over tabellen geen specifiek voorbeeld van een cel met meerdere regels bevat. Zie Geavanceerde opmaaksyntaxis en Basissyntaxis voor opmaak.

Gebruik deze beslissingstabel voordat je een groot document bewerkt:

Bestemming Gedocumenteerde beperking Praktische keuze
Core CommonMark zonder uitbreidingen Pipe-tabellen vallen buiten de kernsyntaxis Gebruik koppen en lijsten
GFM-compatibele renderer Tabellen accepteren inline-inhoud, maar geen blokelementen binnen cellen Probeer een inline regeleinde en controleer de bestemming
Obsidian Tabellen en de tag voor regeleinden zijn gedocumenteerd Bewerk de bron en bekijk daarna de Reading view
Renderer waarvan de HTML-verwerking onbekend is De ondersteuning is niet vastgesteld Voer eerst de kleine vergelijking hieronder uit voordat je een indeling kiest

De eerste drie rijen volgen de hierboven gelinkte CommonMark-specificatie, GFM-specificatie en Obsidian-documentatie. De laatste rij is een aanbevolen verificatiestap: alleen de naam van een renderer zegt niet hoe die met je document omgaat.

Hoe schrijf je twee regels in één cel?

Kopieer het volgende voorbeeld naar een notitie zonder de omliggende codehekken mee te nemen. Elke tabelrij beslaat één fysieke bronregel; de markering voor het regeleinde staat tussen de twee zinsdelen in de tweede cel.

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

Het verwachte resultaat is een tabel met twee kolommen en twee gegevensrijen. In de eerste detailcel staat ‘Pagina’s met stippen’ boven ‘Blauwe omslag’. In de tweede staat ‘Grafietkern’ boven ‘Zeshoekige vorm’. Dit is een verwachte weergave om te controleren, geen ingebedde demonstratie van het gedrag van jouw bestemming.

Het mechanisme combineert een inline HTML-regeleinde met tabelsyntaxis. GitHub documenteert een HTML-tag voor regeleinden als een van de ondersteunde manieren om regeleinden te maken, terwijl Obsidian expliciet <br> documenteert. Dit zijn Markdown-cellen met HTML-ondersteuning, dus de overdraagbaarheid hangt ervan af of de bestemming die opmaak accepteert. Zie de documentatie van GitHub over regeleinden en de documentatie van Obsidian over de basissyntaxis.

Houd de tabelstructuur eenvoudig: laat er een lege regel aan voorafgaan, gebruik evenveel kolommen in de kopregel en de scheidingsregel en gebruik drie koppeltekens per scheidingscel. In de tabelgids van GitHub staan de lege regel en de conventie met drie koppeltekens. Obsidian accepteert minstens twee koppeltekens, dus drie is een handige keuze die in beide systemen werkt. Bronnen: Informatie ordenen met tabellen en Geavanceerde opmaaksyntaxis.

Waarom werken Enter, twee spaties of een backslash hiervoor niet?

CommonMark ondersteunt harde regeleinden met twee afsluitende spaties of een backslash vóór een nieuwe bronregel. Die regels gelden voor inline-inhoud binnen een bestaand blok; ze definiëren geen pipe-tabelcellen met meerdere regels. Zie Harde regeleinden in CommonMark.

Dit voorbeeld is bijvoorbeeld bewust ongeschikt om beide zinsdelen in één GFM-cel te houden:

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

Volgens de tabelregels van GFM is de tweede bronregel een nieuwe rij en geen voortzetting van de detailcel. Een lege regel zou de tabel beëindigen. Houd de volledige rij bij elkaar en plaats het inline regeleinde waar de weergegeven regel moet wisselen. Zie de GFM-tabelvoorbeelden.

Maak ook onderscheid tussen automatisch afbreken van tekst en een bewust ingevoegd regeleinde. Voor deze taak is het resultaat geslaagd als het tweede zinsdeel op een nieuwe regel begint, zelfs wanneer het venster breed genoeg is om beide zinsdelen naast elkaar te tonen. Een schermafbeelding van een smal venster bewijst dat op zichzelf niet.

Hoe controleer je de tabel in Obsidian op een Mac?

Gebruik een tijdelijke notitie met alleen de voorbeeldtabel. Zo kun je makkelijker vaststellen of een probleem door de tabel zelf of door de omringende inhoud wordt veroorzaakt.

  1. Schakel de notitie met de statusbediening voor de bewerkingsmodus over naar Source mode. In deze modus wordt de Markdown precies getoond zoals die is geschreven.
  2. Plak het voorbeeld en controleer of elke gegevensrij op één bronregel blijft staan.
  3. Druk op Cmd+E om tussen bewerken en Reading view te schakelen.
  4. Controleer beide detailcellen: elke cel hoort twee weergegeven regels te bevatten en geen van beide zinsdelen mag naar een nieuwe tabelrij zijn verplaatst.
  5. Keer terug naar de bewerkingsmodus en vergelijk het resultaat ook in Live Preview.

Obsidian documenteert Source mode, Live Preview en de Mac-sneltoets in Weergaven en bewerkingsmodus. Live Preview verbergt een groot deel van de syntaxis tijdens het bewerken; Reading view biedt een aparte, handige controle van de opgemaakte notitie.

Voor een vergelijking naast elkaar houd je Cmd ingedrukt terwijl je op de weergaveschakelaar klikt. Zo open je de bewerkings- en leesweergave tegelijk. Als die bediening verborgen is, beschrijft Obsidian Settings → Appearance → Show tab title bar en een alternatieve bediening in de statusbalk via Settings → Editor → Show editing mode in status bar. Zie Weergaven en bewerkingsmodus.

In de basissyntaxisgids van Obsidian staat Shift+Enter voor regeleinden in alinea’s en een instelling Strict Line Breaks. Deze algemene instructies voor alinea’s bevestigen geen draagbare sneltoets voor tabelcellen. Controleer voor deze test de opgeslagen rij in Source mode en gebruik de expliciete regeleindemarkering in plaats van de instelling als oplossing voor tabelcompatibiliteit te beschouwen. Zie Basissyntaxis voor opmaak.

Hoe kun je verschillen tussen renderers snel vaststellen?

Gebruik naast de voorgestelde versie met meerdere regels ook een controleversie met platte tekst. Het volgende volledige testdocument verandert alleen de markering voor het regeleinde, zodat je tabelondersteuning makkelijker kunt onderscheiden van ondersteuning voor inline HTML:

Control:

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

Multiline candidate:

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

Open dezelfde inhoud in elke beoogde bestemming. Bekijk voor een Markdown-bestand op GitHub de weergegeven bestandsweergave; een voorbeeld in Obsidian bevestigt alleen het resultaat in Obsidian. GitHub documenteert ook verschillend gedrag voor regeleinden in gewone alinea’s tussen Markdown-bestanden en gespreksvelden. Dat onderstreept hoe nuttig het is om de daadwerkelijke bestemming te controleren. Zie Basissyntaxis voor schrijven en opmaken.

Gebruik deze observaties om te bepalen wat je vervolgens moet controleren:

Observatie Volgende controle
Beide voorbeelden worden als tekst met pipe-tekens weergegeven Bevestig dat tabellen worden ondersteund en controleer of de inhoud buiten een codeblok staat
De controleversie werkt, maar de kandidaat toont de tag Controleer of de tag tussen backticks staat of is ge-escaped
De controleversie werkt, maar het regeleinde ontbreekt in de kandidaat Raadpleeg de documentatie van de bestemming over inline HTML
De kandidaat maakt een extra rij aan Controleer de bron op een echte nieuwe regel binnen de bedoelde rij
Een zinsdeel verdwijnt of verschuift naar een andere kolom Zoek naar een niet-ge-escaped pipe in de celinhoud

Dit zijn diagnostische stappen, geen sluitende verklaringen voor elke renderer. Los eerst het kleinste voorbeeld op en voeg daarna de rest van de tabel opnieuw toe. Voor letterlijke pipe-tekens in celtekst documenteert GitHub dat je ze met een backslash kunt escapen, zoals in Dotted \| plain. Zie Inhoud in je tabel opmaken.

Wat kun je gebruiken als cellen met meerdere regels niet worden ondersteund?

Als de bestemming tabellen accepteert maar inline HTML afwijst, gebruik dan één rij per detail. Door de naam van het item te herhalen, blijft de koppeling behouden zonder een regeleinde in de cel nodig te hebben:

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

Als de bestemming alleen core CommonMark ondersteunt, verplaats de details dan naar een kop en lijst:

### Notebook

- Dotted pages
- Blue cover

Koppen en lijsten behoren tot de CommonMark-syntaxis. Deze terugvaloptie biedt ook ruimte om langere vermeldingen uit te breiden zonder afhankelijk te zijn van een tabeluitbreiding.

Plaats een codeblok met hekjes buiten de tabel als je code over meerdere regels wilt weergeven. Als je meerdere bronregels binnen één inline codefragment plaatst, blijven de regeleinden niet behouden: CommonMark normaliseert regeleinden in codefragmenten tot spaties. Zie Codefragmenten.

Kies de indeling op basis van de inhoud die je wilt behouden. Voor twee korte zinsdelen is een inline regeleinde een praktische optie om te controleren. Voor afzonderlijke alinea’s, uitgebreide lijsten of code over meerdere regels verplaats je de details buiten de cel. Bewaar het kleine compatibiliteitsvoorbeeld bij je werkaantekeningen, zodat je de controle kunt herhalen zodra de bestemming verandert.

Bronnen