Horizontale lijn in Markdown: scheidingslijnen, regels en veelvoorkomende oplossingen

Voor een horizontale lijn in Markdown zet je drie koppeltekens op een eigen regel, met een lege regel erboven en eronder:

Einde van het eerste onderdeel.

---

Begin van het volgende onderdeel.

Het resultaat is een scheidingslijn tussen twee alinea’s. Markdown noemt dit een thematische scheiding; HTML geeft deze weer met <hr>. Plak het voorbeeld in de Markdown-viewer om het weergegeven document te controleren.

Drie manieren om een scheidingslijn te schrijven

Al deze vormen leveren een thematische scheiding op:

Markdown-bron	Resultaat
---	Horizontale lijn
***	Horizontale lijn
___	Horizontale lijn
* * *	Horizontale lijn

Gebruik minstens drie gelijke koppeltekens, sterretjes of onderstrepingstekens. Spaties tussen de tekens zijn toegestaan. Verschillende soorten combineren, tekst op dezelfde regel toevoegen of slechts twee tekens gebruiken levert geen lijn op. Dit zijn syntaxisregels uit de CommonMark-specificatie voor thematische scheidingen.

Het aantal koppeltekens bepaalt niet de zichtbare breedte van de lijn. Een reeks van 20 koppeltekens en een reeks van drie leveren hetzelfde HTML-element op; de opmaak op de bestemming bepaalt hoe het eruitziet.

Waarom veranderde mijn horizontale lijn in een kop?

Deze bron plaatst geen scheidingslijn onder ‘Versie-informatie’:

Versie-informatie
---

Dit maakt een kop van niveau twee. Koppeltekens direct onder alineatekst kunnen een Setext-kop vormen, en die interpretatie gaat vóór een horizontale lijn. Voeg een lege regel toe om beide te scheiden:

Versie-informatie

---

Voor een documentonderdeel is een expliciete kop vaak duidelijker:

## Versie-informatie

Het importproces accepteert nu CSV-bestanden.

Gebruik Markdown-koppen om onderdelen een naam te geven. Gebruik een horizontale lijn wanneer de overgang zelf belangrijk is, bijvoorbeeld tussen een brief en een bijlage.

Waarom verschijnt de scheidingslijn als gewone tekst?

Controleer de bron rond de lijn:

Symptoom	Waarschijnlijke oorzaak	Oplossing
Het voorbeeld toont --- in een codeblok	Vier spaties aan het begin van een zelfstandig blok, of een niet afgesloten codeblok	Inspringing verwijderen of het codeblok afsluiten
Het voorbeeld toont --	Slechts twee koppeltekens	Drie of meer gebruiken
Er staat tekst naast de tekens	De regel bevat andere tekst	De tekens op een eigen regel zetten
De lijn verschijnt als --- in een zin	De tekens staan tussen backticks	Backticks verwijderen als je een scheidingslijn bedoelt
De vorige alinea wordt een kop	Geen lege regel boven ---	Een lege regel invoegen

Op het hoogste documentniveau zijn maximaal drie spaties vóór een thematische scheiding toegestaan. Binnen lijsten bepaalt inspringing ook bij welk item de inhoud hoort. Controleer daarom de omringende lijst in plaats van alle spaties te verwijderen.

Een horizontale lijn is iets anders dan een regeleinde

Een scheidingslijn verdeelt onderdelen. Ze verplaatst niet alleen de volgende woorden naar een nieuwe regel.

Gebruik voor een adres een hard regeleinde:

120 Market Street\
San Francisco, CA

Laat voor een nieuwe alinea een lege regel open. Gebruik voor een scheiding tussen onderdelen --- op een aparte regel. De handleiding voor Markdown-regeleinden legt afsluitende spaties, backslashes en GitHubs verschillende gedrag in bestanden en opmerkingen uit.

Een scheidingslijn in een blokcitaat plaatsen

Behoud het voorvoegsel > op elke regel, ook op de scheidingslijn en de lege regels:

> Oorspronkelijk voorstel.
>
> ---
>
> Aanvullende context van de beoordelaar.

De scheidingslijn blijft in het citaat. Als je > vóór de lijn verwijdert, kan het citaat eindigen en de scheidingslijn in het buitenste document terechtkomen. Bekijk de voorbeelden van blokcitaten voor meerdere alinea’s en geneste citaten.

Een tabelscheiding is geen horizontale lijn

Deze regel hoort bij een tabel:

| Formaat | Bewerkbaar |
| --- | :---: |
| Markdown | Ja |

De verticale strepen en optionele dubbele punten beschrijven de kolommen. Ze voegen geen scheidingslijn over de paginabreedte in. Gebruik de Markdown-tabelgenerator om een tabel te maken, of de CSV-naar-Markdown-converter wanneer de gegevens al in een spreadsheet staan.

Horizontale lijnen en geëxporteerde documenten

Een thematische scheiding is geen opdracht voor een pagina-einde. Een PDF- of Word-exporter bepaalt waar pagina’s eindigen op basis van zijn regels voor opmaak en paginering. Voeg geen extra koppeltekens toe in de verwachting dat het volgende onderdeel op een nieuwe pagina begint.

Op een webpagina waarvan je de CSS beheert, kun je het gegenereerde <hr> opmaken in het stylesheet van de site. Een gehoste Markdown-dienst staat eigen CSS mogelijk niet toe. Controleer de uiteindelijke bestemming of het geëxporteerde document, vooral als de scheidingslijn betekenis heeft die bij het afdrukken behouden moet blijven.

Veelgestelde vragen

Heb ik lege regels rond een horizontale lijn nodig?

CommonMark vereist ze niet in elke context, maar ze voorkomen de veelvoorkomende dubbelzinnigheid van --- als kop en maken bronbestanden beter leesbaar.

Kan ik een HTML-tag hr gebruiken?

<hr> werkt in renderers die ruwe HTML toestaan. De Markdown-syntaxis --- past beter bij een Markdown-document. De MD File Viewer-editor verwijdert door gebruikers aangeleverde HTML-tags, terwijl de Markdown-syntaxis voor scheidingslijnen normaal wordt weergegeven.

Hoe toon ik drie koppeltekens zonder een scheidingslijn te maken?

Schrijf een syntaxisvoorbeeld als inline code: `---`. Escape voor gewone tekst op een losse regel het eerste koppelteken: \---.

Houd voor andere gangbare opmaakpatronen het Markdown-spiekbriefje bij de hand.