Vandret linje i Markdown: skillelinjer, regler og almindelige løsninger

For at tilføje en vandret linje i Markdown skal du skrive tre bindestreger på deres egen linje med en tom linje over og under:

Slutningen på det første afsnit.

---

Begyndelsen på det næste afsnit.

Resultatet er en skillelinje mellem to afsnit. Markdown kalder den et tematisk brud; HTML repræsenterer den med <hr>. Indsæt eksemplet i Markdown-fremviseren for at kontrollere det gengivne dokument.

Tre måder at skrive en skillelinje på

Disse former giver alle et tematisk brud:

Markdown-kilde	Resultat
---	Vandret skillelinje
***	Vandret skillelinje
___	Vandret skillelinje
* * *	Vandret skillelinje

Brug mindst tre ens bindestreger, stjerner eller understregningstegn. Mellemrum mellem tegnene er tilladt. Hvis du blander tegntyper, tilføjer tekst på samme linje eller kun bruger to tegn, bliver der ikke oprettet en skillelinje. Disse syntaksregler kommer fra CommonMarks specifikation for tematiske brud.

Antallet af bindestreger bestemmer ikke linjens synlige bredde. En række med 20 bindestreger og en med tre giver samme HTML-element; destinationens formatering bestemmer udseendet.

Hvorfor blev min vandrette linje til en overskrift?

Denne kilde placerer ikke en skillelinje under »Versionsnoter«:

Versionsnoter
---

Den opretter en overskrift på niveau to. Bindestreger direkte under afsnitstekst kan danne en Setext-overskrift, og den fortolkning har forrang frem for en vandret skillelinje. Tilføj en tom linje for at adskille de to:

Versionsnoter

---

Til et dokumentafsnit er en eksplicit overskrift ofte tydeligere:

## Versionsnoter

Importforløbet accepterer nu CSV-filer.

Brug Markdown-overskrifter til at navngive afsnit. Brug en vandret skillelinje, når selve overgangen er vigtig, for eksempel mellem et brev og et bilag.

Hvorfor vises skillelinjen som almindelig tekst?

Kontrollér kilden omkring linjen:

Symptom	Sandsynlig årsag	Løsning
Forhåndsvisningen viser --- i en kodeblok	Fire mellemrum i starten af en selvstændig blok eller en kodeblok, som ikke er lukket	Fjern indrykningen, eller luk kodeblokken
Forhåndsvisningen viser --	Kun to bindestreger	Brug tre eller flere
Der står tekst ved siden af tegnene	Linjen indeholder anden tekst	Sæt tegnene på deres egen linje
Linjen vises som --- inde i en sætning	Tegnene står mellem backticks	Fjern backticks, hvis du vil have en skillelinje
Det foregående afsnit bliver en overskrift	Ingen tom linje over ---	Indsæt en tom linje

På dokumentets øverste niveau er op til tre indledende mellemrum tilladt for et tematisk brud. I lister bestemmer indrykningen også, hvilket punkt indholdet tilhører, så kontrollér den omgivende liste i stedet for at fjerne alle mellemrum.

En vandret linje er forskellig fra et linjeskift

En skillelinje adskiller afsnit. Den flytter ikke blot de følgende ord til en ny linje.

Brug et hårdt linjeskift til en adresse:

120 Market Street\
San Francisco, CA

Lad en linje være tom for at oprette et nyt afsnit. Brug --- på en separat linje til at adskille afsnit. Vejledningen til Markdown-linjeskift forklarer afsluttende mellemrum, omvendte skråstreger og GitHubs forskellige håndtering af linjeskift i filer og kommentarer.

Indsæt en skillelinje i et blokcitat

Behold præfikset > på hver linje, også skillelinjen og de tomme linjer:

> Oprindeligt forslag.
>
> ---
>
> Yderligere kontekst fra korrekturlæseren.

Skillelinjen forbliver inde i citatet. Hvis du fjerner > fra linjen, kan det afslutte citatet og flytte skillelinjen ud i det ydre dokument. Se eksemplerne på blokcitater for flere afsnit og indlejrede citater.

En tabelseparator er ikke en vandret skillelinje

Denne linje hører til en tabel:

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

De lodrette streger og valgfrie koloner beskriver kolonnerne. De indsætter ikke en skillelinje i hele sidens bredde. Brug Markdown-tabelgeneratoren til at oprette en tabel eller CSV til Markdown-konverteren, når dataene allerede findes i et regneark.

Vandrette skillelinjer og eksporterede dokumenter

Et tematisk brud er ikke en kommando til sideskift. En PDF- eller Word-eksportør bestemmer, hvor sider slutter, ud fra sine layout- og pagineringsregler. Tilføj ikke ekstra bindestreger i forventning om, at det næste afsnit starter på en ny side.

På en webside, hvor du kontrollerer CSS, kan det genererede <hr> formateres i webstedets typografiark. En hostet Markdown-tjeneste tillader muligvis ikke brugerdefineret CSS. Kontrollér den endelige destination eller det eksporterede dokument, især hvis skillelinjen har en betydning, som skal bevares ved udskrivning.

Ofte stillede spørgsmål

Skal der være tomme linjer omkring en vandret skillelinje?

CommonMark kræver dem ikke i alle sammenhænge, men de undgår den almindelige tvetydighed, hvor --- bliver en overskrift, og gør kildefiler lettere at læse.

Kan jeg bruge et HTML-tag hr?

<hr> virker i renderere, der tillader rå HTML. Markdown-syntaksen --- passer bedre til et Markdown-dokument. MD File Viewer-editoren fjerner HTML-tags, som brugeren indtaster, mens Markdown-syntaksen for skillelinjer gengives normalt.

Hvordan viser jeg tre bindestreger uden at lave en skillelinje?

Skriv et syntakseksempel som inline-kode: `---`. Til almindelig tekst på en selvstændig linje skal du escape den første bindestreg: \---.

Hav Markdown-huskearket ved hånden til andre almindelige formateringsmønstre.