Horisontell linje i Markdown: avdelare, regler och vanliga lösningar

För att lägga till en horisontell linje i Markdown skriver du tre bindestreck på en egen rad, med en tom rad ovanför och under:

Slutet av det första avsnittet.

---

Början av nästa avsnitt.

Resultatet är en avdelare mellan två stycken. Markdown kallar den en tematisk brytning; HTML representerar den med <hr>. Klistra in exemplet i Markdown-visaren för att kontrollera det renderade dokumentet.

Tre sätt att skriva en avdelare

Alla dessa former ger en tematisk brytning:

Markdown-källa	Resultat
---	Horisontell linje
***	Horisontell linje
___	Horisontell linje
* * *	Horisontell linje

Använd minst tre likadana bindestreck, asterisker eller understreck. Mellanslag mellan markörerna är tillåtna. Att blanda markörtyper, lägga till text på samma rad eller använda bara två markörer skapar ingen linje. Dessa syntaxregler kommer från CommonMarks specifikation för tematiska brytningar.

Antalet bindestreck styr inte linjens visuella bredd. En rad med 20 bindestreck och en med tre skapar samma HTML-element; destinationens formatering avgör utseendet.

Varför blev min horisontella linje en rubrik?

Den här källan placerar inte en avdelare under ”Versionsinformation”:

Versionsinformation
---

Den skapar en rubrik på nivå två. Bindestreck direkt under stycketext kan bilda en Setext-rubrik, och den tolkningen har företräde framför en horisontell linje. Lägg till en tom rad för att skilja dem åt:

Versionsinformation

---

För ett dokumentavsnitt är en uttrycklig rubrik ofta tydligare:

## Versionsinformation

Importflödet accepterar nu CSV-filer.

Använd Markdown-rubriker för att namnge avsnitt. Använd en horisontell linje när själva övergången är viktig, till exempel mellan ett brev och en bilaga.

Varför visas avdelaren som vanlig text?

Kontrollera källan runt linjen:

Symtom	Trolig orsak	Åtgärd
Förhandsvisningen visar --- i ett kodblock	Fyra mellanslag i början av ett fristående block eller ett kodblock som inte avslutats	Ta bort indraget eller avsluta kodblocket
Förhandsvisningen visar --	Bara två bindestreck	Använd tre eller fler
Text visas bredvid markörerna	Raden innehåller annan text	Placera markörerna på en egen rad
Linjen visas som --- i en mening	Markörerna är inom backtick-tecken	Ta bort backtick-tecknen om du vill ha en avdelare
Föregående stycke blir en rubrik	Ingen tom rad ovanför ---	Infoga en tom rad

På dokumentets översta nivå tillåts upp till tre inledande mellanslag för en tematisk brytning. I listor avgör indraget även vilket objekt innehållet tillhör, så kontrollera den omgivande listan i stället för att ta bort alla mellanslag.

En horisontell linje är inte en radbrytning

En avdelare skiljer avsnitt åt. Den flyttar inte bara de följande orden till en ny rad.

Använd en hård radbrytning för en adress:

120 Market Street\
San Francisco, CA

Lämna en tom rad för ett nytt stycke. Använd --- på en separat rad för att skilja avsnitt åt. Guiden till radbrytningar i Markdown förklarar avslutande mellanslag, omvända snedstreck och GitHubs olika radbrytningsbeteende i filer och kommentarer.

Placera en avdelare i ett blockcitat

Behåll prefixet > på varje rad, även avdelaren och de tomma raderna:

> Ursprungligt förslag.
>
> ---
>
> Ytterligare sammanhang från granskaren.

Avdelaren stannar inne i citatet. Om du tar bort > från linjen kan citatet avslutas och avdelaren flyttas till det yttre dokumentet. Se exemplen på blockcitat för flera stycken och nästlade citat.

En tabellavgränsare är ingen horisontell linje

Den här raden hör till en tabell:

| Format | Redigerbart |
| --- | :---: |
| Markdown | Ja |

De lodräta strecken och de valfria kolonen beskriver kolumnerna. De infogar ingen avdelare över hela sidans bredd. Använd Markdown-tabellgeneratorn för att skapa en tabell, eller CSV till Markdown-konverteraren när data redan finns i ett kalkylblad.

Horisontella linjer och exporterade dokument

En tematisk brytning är inget sidbrytningskommando. En PDF- eller Word-exportör avgör var sidor slutar utifrån sina layout- och sidindelningsregler. Lägg inte till fler bindestreck i förväntan att nästa avsnitt ska börja på en ny sida.

På en webbsida vars CSS du kontrollerar kan det genererade <hr> formateras i webbplatsens formatmall. En värdbaserad Markdown-tjänst kanske inte tillåter egen CSS. Kontrollera slutdestinationen eller det exporterade dokumentet, särskilt om avdelaren förmedlar en betydelse som måste finnas kvar vid utskrift.

Vanliga frågor

Behöver jag tomma rader runt en horisontell linje?

CommonMark kräver dem inte i alla sammanhang, men de undviker den vanliga tvetydigheten med --- som rubrik och gör källfilerna lättare att läsa.

Kan jag använda en HTML-tagg hr?

<hr> fungerar i renderare som tillåter rå HTML. Markdown-syntaxen --- passar bättre i ett Markdown-dokument. MD File Viewer-redigeraren tar bort HTML-taggar som användaren anger, medan Markdown-syntaxen för avdelare renderas normalt.

Hur visar jag tre bindestreck utan att skapa en avdelare?

Skriv syntaxexempel som inbäddad kod: `---`. För vanlig text på en fristående rad använder du escape före det första bindestrecket: \---.

Ha Markdown-fusklappen nära till hands för andra vanliga formateringsmönster.