Blokcitaten in Markdown: citaten, meerdere alinea's en lijsten

Een Markdown-blokcitaat begint met > gevolgd door een spatie. Zet de markering aan het begin van elke geciteerde regel om de bron leesbaar en makkelijk te bewerken te houden.

> De bijgewerkte installatiehandleiding is klaar voor beoordeling.

Het resultaat is een geciteerde alinea, geen codeblok. De rand, inspringing en kleur hangen af van het thema van de pagina of het document. De tekst van het citaat blijft gewone Markdown en kan dus nadruk, links, lijsten en andere documentstructuren bevatten.

Gebruik de Markdown-viewer om de voorbeelden uit te proberen en exporteer daarna een document via de Markdown-naar-Word-converter wanneer je een bewerkbare beoordelingskopie nodig hebt.

Citeer een alinea over meerdere bronregels

Herhaal de markering voor een langer citaat:

> De bijgewerkte installatiehandleiding is klaar voor beoordeling.
> Controleer de vereisten voordat je de release goedkeurt.

Deze twee bronregels vormen één alinea in het voorbeeld op deze site. Een regeleinde in de bron dwingt niet noodzakelijk een zichtbare regelafbreking af. Voeg een expliciete afbreking toe wanneer de tekst op twee regels moet blijven:

> Beoordeling van de documentatie\
> Toegewezen aan de releaseverantwoordelijke

De backslash hoort vóór het regeleinde; de volgende regel begint nog steeds met de citaatmarkering. Zie regeleinden in Markdown voor het verschil tussen harde regelafbrekingen en alinea-einden.

Neem meerdere alinea's op in één citaat

Zet een citaatmarkering op de anders lege regel tussen alinea's:

> Het eerste concept beschrijft het installatieproces.
>
> Het tweede concept voegt stappen voor probleemoplossing en voorbeelden toe.

Dit maakt één blokcitaat met twee alinea's. Door > op de scheidingsregel te laten staan, blijft de bedoelde groepering zichtbaar, vooral als iemand de passage later bewerkt.

Laat een lege regel vrij en ga zonder markering verder om je eigen tekst te hervatten:

> Bij de beoordeling werd om een kortere installatiesectie gevraagd.

We hebben de uitgebreide configuratieopmerkingen naar een bijlage verplaatst.

Verwijder > niet van een vervolgregel zonder een lege regel toe te voegen. Sommige Markdown-parsers behandelen dat als een impliciete voortzetting van de geciteerde alinea. De CommonMark-specificatie voor blokcitaten beschrijft dit gedrag. Expliciete markeringen en een duidelijke lege regel zijn makkelijker te onderhouden voor mensen die samenwerken.

Voeg nadruk, links en bronvermelding toe

De inhoud van een blokcitaat kan gewone inline-opmaak gebruiken:

> **Beoordelingsopmerking:** De migratiestappen hebben een werkend voorbeeld nodig.
> Zie de [releasechecklist](https://example.com/checklist).
>
> Feedback uit de documentatiebeoordeling, september 2026.

Markdown kent de laatste regel geen speciale rol als bronvermelding toe. Het is gewone alinea-inhoud binnen het citaat. Voeg de bron, auteur en link toe waar dat nodig is en controleer de toestemming voordat je een passage van iemand anders overneemt.

Een blokcitaat voegt ook geen letterlijke aanhalingstekens toe. Typ die zelf als het uiteindelijke document ze vereist. Voor een kort citaat binnen je eigen zin kunnen gewone aanhalingstekens voldoende zijn zonder een apart blok te maken.

Nest een citaat of voeg een lijst toe

Gebruik een extra niveau van > voor geciteerd materiaal binnen het buitenste citaat:

> De beoordelaar vatte het eerdere verzoek samen:
>
> > Voeg een volledig voorbeeld van het configuratiebestand toe.
>
> Het bijgewerkte concept bevat dat voorbeeld nu.

Beperk de nestingsdiepte in een rapport. Diep geneste citaten verkleinen de beschikbare tekstbreedte, waardoor PDF- en Word-documenten moeilijker leesbaar kunnen worden.

Een lijst binnen een citaat behoudt de markering op elke regel:

> De beoordeling wees op twee wijzigingen:
>
> - Leg de vereiste machtigingen uit.
> - Voeg een sectie voor probleemoplossing toe.

Voor de omgekeerde structuur, een citaat binnen een lijst, laat je het citaat onder de tekst van het lijstitem inspringen:

- Feedback op de documentatie

  > Voeg vóór publicatie een sectie voor probleemoplossing toe.
- Releasechecklist

Als het citaat buiten het item verschijnt, vergelijk dan de inspringing met de voorbeelden in de handleiding voor inspringen in Markdown.

GitHub-meldingen vereisen ondersteuning op de bestemming

GitHub ondersteunt speciale meldingen op basis van citaatsyntaxis, waaronder deze vorm:

> [!NOTE]
> Maak een reservekopie van de configuratie voordat je die wijzigt.

GitHub beschrijft de ondersteunde typen in de naslag voor meldingen. De kleuren en pictogrammen van meldingen zijn platformfuncties, geen eigenschappen van elk Markdown-citaat.

De renderer van deze site past de meldingsopmaak van GitHub niet toe. Het voorbeeld blijft een blokcitaat met een zichtbaar [!NOTE]-label. Gebruik voor een document dat op verschillende bestemmingen duidelijk leesbaar moet blijven een expliciet vet label:

> **Opmerking:** Maak een reservekopie van de configuratie voordat je die wijzigt.

Zo blijft de betekenis begrijpelijk zonder een speciale uitbreiding voor meldingen. Dezelfde aanpak werkt voor een waarschuwing, een beoordelingsbesluit of een redactionele opmerking.

Los problemen met citaten op vóór het exporteren

Als > letterlijk verschijnt, controleer dan of het voorbeeld tussen backticks, in een afgebakend codeblok of in een ingesprongen codeblok staat. Die contexten zijn bedoeld om brontekst te tonen. Een backslash vóór de markering zorgt er ook voor dat die letterlijk wordt weergegeven.

Als te veel tekst wordt geciteerd, voeg dan een lege regel toe vóór de alinea die buiten het citaat moet doorgaan. Is genest materiaal moeilijk te volgen, verminder dan de nesting en voeg de bronvermelding als gewone alinea toe.

Open ten slotte het geëxporteerde DOCX-bestand en controleer lange citaten en geciteerde lijsten. De linkerrand in een browser en de alineaopmaak van een Word-document kunnen verschillen. Gebruik de Markdown-naar-HTML-tool om de tussenliggende structuur te bekijken wanneer je een probleem met de bronopmaak moet onderscheiden van een probleem met de exportstijl.