Verwijder de voorafgaande tab of inspringing van vier spaties om te voorkomen dat proza na een Markdown-codeblok code wordt. Wil je in Obsidian op je Mac ook een zichtbare inspringing van de alinea, laat de Markdown dan oningesprongen en pas die inspringing toe met CSS.

Waarom wordt de alinea een nieuw codeblok?

Een afsluitend hekwerk beëindigt een afgeschermd codeblok, maar schakelt de syntaxis voor inspringing niet uit voor de tekst eronder. Op het hoogste niveau kunnen vier of meer voorafgaande spaties een afzonderlijk ingesprongen codeblok beginnen. Het volgende voorbeeld bevat daarom twee codeblokken, hoewel alleen het eerste hekjes heeft. CommonMark: ingesprongen codeblokken.

```text
Sample output
```

    This should be a normal paragraph.

Het belangrijke verschil is of de ongewenste tekst bij het oorspronkelijke afgeschermde blok hoort of een nieuw blok begint. Als het afsluitende hekwerk zelf zichtbaar blijft in de code, controleer dan of het hetzelfde teken gebruikt als het openende hekwerk en minstens evenveel backticks of tildes bevat. Plaats bij een blok op het hoogste niveau beide hekwerken tegen de linkermarge om het controleren eenvoudiger te maken. GitHub Flavored Markdown: afgeschermde codeblokken.

Lege regels kunnen een inspringing van vier spaties niet ongedaan maken. Omgekeerd kan ingesprongen tekst direct na een gewone alinea deel blijven uitmaken van die alinea, omdat een ingesprongen codeblok die niet kan onderbreken. Daardoor kan een vergelijkbare inspringing zich elders in een notitie soms anders gedragen. CommonMark: ingesprongen codeblokken.

Hoe herstel je een gewone alinea op een Mac?

Schakel in Obsidian over naar Source mode zodat je de daadwerkelijke hekwerken en voorafgaande witruimte kunt bekijken. Gebruik de bediening voor de bewerkingsmodus in de statusbalk, of kies Settings → Editor → Default editing mode → Source mode. Obsidian beschrijft deze modus als een weergave van de Markdown-syntaxis precies zoals die is geschreven. Weergaven en bewerkingsmodus.

Zoek de eerste regel met proza na het afsluitende hekwerk. Verwijder de voorafgaande spaties of tab en laat de tekst tegen de linkermarge staan. Herhaal dit voor eventuele volgende alinea’s met hetzelfde probleem. Behoud de inspringing binnen het bedoelde codeblok.

Gebruik dit volledige Markdown-voorbeeld als referentie:

```text
Sample output
```

This is a normal paragraph with **bold text**.

This is another normal paragraph.

Laat voor een leesbare bron een lege regel staan na het afsluitende hekwerk. GitHub raadt expliciet lege regels rond afgeschermde codeblokken aan, hoewel de heksyntaxis ze niet vereist. De buitenste hekwerken met vier backticks waarmee voorbeelden in dit artikel worden weergegeven, zorgen ervoor dat de binnenste driedubbele backticks zichtbaar blijven. Codeblokken maken en markeren.

Schakel over naar Reading view om het resultaat te bekijken; op macOS wissel je met Cmd+E tussen bewerken en lezen. Controleer of de toelichting de normale alinea-opmaak gebruikt en of vette tekst vet wordt weergegeven. Live Preview verbergt een groot deel van de Markdown-syntaxis en toont die rond de cursor. Gebruik daarom Source mode om het probleem vast te stellen en Reading view voor de uiteindelijke visuele controle. Weergaven en bewerkingsmodus.

Als je slechts twee spaties van een inspringing van vier spaties verwijdert, wordt de tekst op het hoogste niveau mogelijk niet meer als code verwerkt, maar ontstaat er geen zichtbare inspringing van de alinea. Obsidian legt uit dat aangrenzende gewone spaties in de weergegeven tekst worden samengevoegd. Inspringing in de bron en inspringing in de weergave zijn twee verschillende dingen. Basisopmaaksyntaxis.

Hoe behoud je een zichtbare inspringing van alinea’s in Obsidian?

Gebruik voor een inspringing van de eerste regel gewone alinea’s met een CSS-fragment. Zo blijft de alinea-indeling gescheiden van de presentatie: de Markdown blijft leesbaar, terwijl CSS de visuele inspringing verzorgt. Obsidian ondersteunt aangepaste fragmenten en een eigenschap cssclasses waarmee je een stijl op geselecteerde notities toepast. CSS-fragmenten.

Hieronder staat een voorbeeldstijl die is gebaseerd op Obsidian’s gedocumenteerde mechanisme met klassen en CSS-inspringing van alinea’s. Dit is geen ingebouwde opmaakopdracht van Obsidian. De stijl richt zich op weergegeven alinea-elementen; controleer het resultaat in Reading view.

Voeg de notitie-eigenschap en het stijlblad toe

Zet dit eigenschappenblok helemaal bovenaan de notitie. Als de notitie al een eigenschappenblok heeft, voeg dan daar cssclasses aan toe in plaats van een tweede blok te maken. Laat het proza na je codehekwerk oningesprongen.

---
cssclasses:
  - paragraph-indent
---

Maak een bestand met platte tekst en de naam paragraph-indent.css met dit volledige stijlblad:

.paragraph-indent p {
  text-indent: 2em;
}

De selector p richt zich op alinea’s binnen de aangepaste notitieklasse. De eigenschap text-indent laat de eerste regel inspringen; afgebroken regels behouden hun normale beginpositie. De waarde 2em is een voorbeeld dat je kunt aanpassen. Er worden geen spaties aan de notitie toegevoegd. MDN: text-indent.

Gebruik op je Mac een teksteditor die platte tekst ondersteunt voor het stijlblad. Kies je TextEdit, selecteer dan Format → Make Plain Text voordat je het bestand opslaat. Controleer of de uiteindelijke bestandsnaam paragraph-indent.css is, en niet die van een document met opgemaakte tekst of een bestand dat eindigt op .css.txt. Apple legt uit dat omzetten naar platte tekst de documentopmaak verwijdert en het bestand normaal gesproken met de extensie .txt opslaat. Documenten aanmaken, openen en converteren in TextEdit op de Mac.

  1. Open in Obsidian Settings → Appearance → CSS snippets.
  2. Selecteer Open snippets folder en plaats paragraph-indent.css daar.
  3. Selecteer Reload snippets als het bestand niet in de lijst staat.
  4. Schakel de fragmentoptie in en bekijk de notitie vervolgens in Reading view. CSS-fragmenten.

Dit brede voorbeeld laat elke weergegeven alinea inspringen die binnen de geselecteerde notitie aan de selector voldoet, ook alinea’s binnen andere structuren. Het beperkt het effect niet tot de alinea direct na een codeblok. Schakel het fragment uit of verwijder de klasse paragraph-indent uit de notitie om de stijl ongedaan te maken.

Het stijlblad herstelt geen tekst die nog steeds als code wordt verwerkt: de selector richt zich op alinea’s. Corrigeer eerst de witruimte. Bovendien is deze alineaselector geen volledige stijl voor de editor in Live Preview; verwacht dus niet dat de editor en de leesweergave er hetzelfde uitzien.

Wat verandert er binnen een lijst of op GitHub?

Inspringing binnen een lijst bepaalt of tekst bij een lijstitem hoort. Verwijder die niet zonder onderscheid. In dit volledige voorbeeld hebben het hekwerk en de toelichting drie voorafgaande spaties, zodat ze uitlijnen met de inhoud na 1. . De toelichting blijft een alinea binnen dat item. GitHub Flavored Markdown: lijstitems.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Bereken voor andere lijstmarkeringen de inspringing voor vervolgregels op basis van de markering en de daaropvolgende witruimte. Een algemene instructie om alle inspringing te verwijderen zou de bedoelde structuur beschadigen. Moet de toelichting buiten de lijst vallen, plaats die dan tegen de linkermarge. GitHub Flavored Markdown: lijstitems.

Obsidian documenteert ondersteuning voor CommonMark en GitHub Flavored Markdown, naast de eigen uitbreidingen. Daardoor is een CSS-fragment van Obsidian nog geen overdraagbare Markdown-opmaak: het fragment moet afzonderlijk in Obsidian worden ingesteld. Controleer de daadwerkelijke weergave op de bestemming wanneer je een notitie verplaatst. Obsidian documenteert ook dat Markdown binnen HTML-elementen niet wordt verwerkt. Een HTML-wrapper verandert dus de opmaakvoorwaarden en biedt geen universele oplossing. Obsidian Flavored Markdown.

Welke oplossing moet je kiezen?

Kies de kleinste wijziging die het gewenste resultaat oplevert:

  • Gewone tekst na code: verwijder de voorafgaande tab of inspringing van vier spaties van de alinea.
  • Een alinea binnen een lijstitem: behoud de inspringing die nodig is voor de inhoud van dat item.
  • Een zichtbare inspringing van de eerste regel in Obsidian: gebruik oningesprongen proza met het afgebakende CSS-voorbeeld.
  • Een document dat in meerdere apps wordt bekeken: behoud een duidelijke Markdown-structuur en controleer de weergave afzonderlijk in elke app.

Stel jezelf bij het controleren van de voltooide notitie twee vragen: wordt de tekst als een alinea verwerkt, en heeft die alinea de gewenste inspringing? Corrigeer eerst de Markdown-structuur. Pas daarna de visuele inspringing toe op plaatsen waar de weergave-engine dat ondersteunt, en houd het stijlblad gescheiden van het proza.

Bronnen