Om du vill visa flera rader i en Markdown-tabellcell håller du raden på en enda källrad och infogar <br> mellan fraserna. Det här fungerar där tabeller och inline-HTML stöds. Kontrollera Obsidian och renderaren där du ska använda innehållet innan du förlitar dig på det.

Den här guiden tar upp en praktisk uppgift på Mac-datorn: att skriva en liten tabell i Obsidian, kontrollera hur den ser ut och förbereda samma Markdown för GitHub eller en annan renderare. Exemplen använder påhittade beskrivningar av pappersvaror. Kompatibilitetskontrollerna nedan är ett arbetsflöde baserat på dokumentationen, inte resultat från tester av installerade appar.

Vilka Markdown-renderare stöder tabellceller med flera rader?

Pipetabeller är ett tillägg, inte en del av CommonMark-kärnan. GitHub Flavored Markdown, eller GFM, lägger till tabeller vars celler kan innehålla inline-innehåll. Specifikationen tillåter inte blockelement i dessa celler. Därför skiljer sig en cell med flera visade rader från en cell med separata stycken, en Markdown-lista eller ett kodblock med kodstängsel. Se GFM:s tabellspecifikation.

Obsidian dokumenterar pipetabeller och formatering i celler. Dokumentationen för grundläggande syntax identifierar också <br> som en tagg för radbrytning. Tillsammans utgör detta den dokumenterade grunden för metoden här, även om tabellsidan inte innehåller något särskilt exempel på celler med flera rader. Se Avancerad formateringssyntax och Grundläggande formateringssyntax.

Använd den här beslutstabellen innan du redigerar ett stort dokument:

Mål Dokumenterad begränsning Praktiskt val
Core CommonMark utan tillägg Pipetabeller ingår inte i kärnsyntaxen Använd rubriker och listor
GFM-kompatibel renderare Tabeller tillåter inline-innehåll, men inga blockelement i cellerna Prova en inline-radbrytning och kontrollera resultatet på målet
Obsidian Tabeller och radbrytningstaggen är dokumenterade Redigera källan och granska sedan läsvyn
Renderare med okänd HTML-hantering Stödet är inte fastställt Gör den lilla jämförelsen nedan innan du väljer format

De tre första raderna bygger på CommonMark-specifikationen, GFM-specifikationen och Obsidian-dokumentationen som länkas ovan. Den sista raden är ett rekommenderat verifieringssteg: renderarens namn visar inte i sig hur den hanterar dokumentet.

Hur skriver du två rader i en och samma cell?

Kopiera följande exempel till en anteckning utan att ta med det omgivande kodstängslet. Varje tabellrad upptar en fysisk källrad. Radbrytningsmarkören står mellan de två fraserna i den andra cellen.

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

Det avsedda resultatet är en tabell med två kolumner och två datarader. I den första detaljcellen visas ”Prickade sidor” ovanför ”Blått omslag”. I den andra visas ”Grafitkärna” ovanför ”Sexkantig form”. Detta är ett förväntat resultat att kontrollera, inte en inbäddad demonstration av hur renderaren på ditt mål fungerar.

Metoden kombinerar en inline-HTML-radbrytning med tabellsyntax. GitHub dokumenterar en HTML-tagg för radbrytning bland de stödda sätten att skapa radbrytningar, medan Obsidian uttryckligen dokumenterar <br>. Det här är Markdown-celler med hjälp av HTML, så portabiliteten beror på att målet accepterar den markeringen. Se GitHubs dokumentation om radbrytningar och Obsidians dokumentation om grundläggande syntax.

Håll tabellstrukturen enkel: lägg en tom rad före tabellen, använd lika många kolumner i rubrik- och avgränsarraderna och skriv tre bindestreck i varje avgränsarcell. GitHubs tabellguide dokumenterar den tomma raden och konventionen med tre bindestreck. Obsidian godtar minst två bindestreck, så tre är ett praktiskt gemensamt val. Källor: Organisera information med tabeller och Avancerad formateringssyntax.

Varför fungerar inte Enter, två mellanslag eller ett omvänt snedstreck?

CommonMark stöder hårda radbrytningar med två avslutande mellanslag eller ett omvänt snedstreck före en källradbrytning. Reglerna gäller inline-innehåll i ett befintligt block. De definierar inte pipetabellceller med flera rader. Se CommonMarks hårda radbrytningar.

Det här exemplet är avsiktligt olämpligt om båda fraserna ska vara kvar i en och samma GFM-cell:

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

Enligt GFM:s tabellregler blir den andra källraden en ny rad i stället för en fortsättning på detaljcellen. En tom rad skulle avsluta tabellen. Håll hela tabellraden samlad och placera inline-radbrytningen där den visade raden ska bytas. Se GFM:s tabellexempel.

Skilj också mellan automatisk radbrytning och en avsiktlig radbrytning. För den här uppgiften innebär ett lyckat resultat att den andra frasen börjar på en ny rad även när fönstret är tillräckligt brett för att rymma båda fraserna. En skärmbild från ett smalt fönster räcker inte för att visa det.

Hur kontrollerar du tabellen i Obsidian på en Mac?

Använd en tillfällig anteckning som bara innehåller exempeltabellen. Då blir det lättare att avgöra om ett problem beror på själva tabellen eller på det omgivande innehållet.

  1. Växla anteckningen till Källäge med redigeringslägets statuskontroll. I det här läget visas Markdown precis som den är skriven.
  2. Klistra in exemplet och kontrollera att varje datarad fortfarande ligger på en enda källrad.
  3. Tryck på Cmd+E för att växla mellan redigeringsläget och Läsvy.
  4. Granska båda detaljcellerna: varje cell ska innehålla två visade rader, och ingen fras ska ha flyttats till en ny tabellrad.
  5. Gå tillbaka till redigeringsläget och jämför även resultatet i Live Preview.

Obsidian dokumenterar Källäge, Live Preview och Mac-genvägen i Vyer och redigeringsläge. Live Preview döljer en stor del av syntaxen medan du redigerar. Läsvy ger en separat kontroll av den formaterade anteckningen.

Om du vill jämföra vyerna sida vid sida håller du ned Cmd medan du klickar på vyväljaren för att öppna redigerings- och läsvyer samtidigt. Om kontrollen är dold dokumenterar Obsidian Inställningar → Utseende → Visa flikens namnlist och en alternativ kontroll i statusfältet under Inställningar → Redigerare → Visa redigeringsläge i statusfältet. Se Vyer och redigeringsläge.

Obsidians guide till grundläggande syntax beskriver Shift+Enter för radbrytningar i stycken och inställningen Strikta radbrytningar. De allmänna instruktionerna för stycken visar inte att det finns en portabel genväg för tabellceller. Kontrollera den sparade raden i Källäge och använd den uttryckliga radbrytningsmarkören i stället för att se inställningen som en lösning på tabellkompatibilitet. Se Grundläggande formateringssyntax.

Hur felsöker du snabbt skillnader mellan renderare?

Använd ett oformaterat textelement som kontroll vid sidan av versionen med flera rader. I följande kompletta testdokument ändras bara radbrytningsmarkören, vilket gör det lättare att skilja stöd för tabeller från stöd för inline-HTML:

Control:

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

Multiline candidate:

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

Öppna samma innehåll på varje mål du tänker använda. För en Markdown-fil på GitHub granskar du den renderade filvyn. En förhandsvisning i Obsidian visar bara resultatet i Obsidian. GitHub dokumenterar också att vanliga radbrytningar i stycken fungerar olika i Markdown-filer och konversationsfält, vilket understryker värdet av att kontrollera det faktiska målet. Se Grundläggande syntax för skrivning och formatering.

Använd följande observationer för att avgöra vad du ska kontrollera härnäst:

Observation Nästa kontroll
Båda exemplen visas som text med lodräta streck Bekräfta att tabeller stöds och kontrollera att innehållet ligger utanför ett kodstängsel
Kontrollexemplet fungerar, men taggen visas i kandidatversionen Kontrollera om taggen står inom bakåtcitattecken eller har escapats
Kontrollexemplet fungerar, men radbrytningen försvinner i kandidatversionen Läs dokumentationen om inline-HTML för målet
Kandidatversionen skapar ytterligare en rad Kontrollera om källan innehåller en faktisk radbrytning i den avsedda raden
En fras försvinner eller flyttas till en annan kolumn Leta efter ett oescapat lodrätt streck i cellinnehållet

Det här är felsökningsspår, inte säkra förklaringar för varje renderare. Åtgärda det minsta exemplet först och lägg sedan tillbaka resten av tabellen. Om celltexten innehåller lodräta streck dokumenterar GitHub att de kan escapats med ett omvänt snedstreck, som i Dotted \| plain. Se Formatera innehåll i tabellen.

Vad ska du använda när celler med flera rader inte stöds?

Om målet stöder tabeller men inte inline-HTML kan du använda en rad per detalj. Om du upprepar namnet på objektet bevaras kopplingen utan att en radbrytning i cellen behövs:

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

Om målet bara stöder CommonMark-kärnan flyttar du detaljerna till en rubrik och en lista:

### Notebook

- Dotted pages
- Blue cover

Rubriker och listor ingår i CommonMark-syntaxen. Den här reservlösningen ger också längre poster utrymme att växa utan att vara beroende av ett tabelltillägg.

Placera kod med flera rader i ett kodblock med kodstängsel utanför tabellen. Om du omsluter flera källrader i ett enda kodspann bevaras inte radbrytningarna: CommonMark normaliserar radslut i kodspann till mellanslag. Se Kodspann.

Välj format efter vilket innehåll du behöver bevara. För två korta fraser är en inline-radbrytning ett praktiskt alternativ att kontrollera. För separata stycken, längre listor eller kod med flera rader flyttar du detaljen utanför cellen. Spara det lilla kompatibilitetsexemplet bland dina arbetsanteckningar så att du kan göra om kontrollen när målet ändras.

Källor