Markdown Cheat Sheet: Syntaxis, Opmaak & Structuur – Snelreferentie
Snelle referentie voor Markdown: koppen, lijsten, code, tabellen en meer.
Markdown-taal wordt gebruikt op Wikipedia en Hugo. Het biedt ondersteuning voor kopteksten, lijsten, wijzigingen van letterstijl, afbeeldingen, codeblokken en tabellen. Hieronder vind je een korte samenvatting van Markdown-opmaak.
De bovenstaande afbeelding is gegenereerd door Flux - tekst-naar-beeld AI.
Markdown is een lichtgewicht markuptaal die je kunt gebruiken om opmakelementen toe te voegen aan platte tekstbestanden. Deze gids biedt een uitgebreid overzicht van de meest gebruikte Markdown-syntaxis, waarmee je goed gestructureerde en visueel aantrekkelijke documenten kunt maken.
Deze cheat sheet is onderdeel van de Documentatietools in 2026: Markdown, LaTeX, PDF & Printworkflows hub.
Markdown-kopteksten (H1–H6)
Kopteksten in Markdown worden gemaakt met het hashtag-symbool (#). Het aantal hashtags voor de koptekst geeft het niveau van de koptekst aan.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Vet, cursief en nadruk
Markdown biedt verschillende manieren om tekst te benadrukken. Je kunt asterisk (*) of underscores (_) gebruiken voor cursief, en dubbele asterisks (**) of dubbele underscores (__) voor vetgedrukt.
Cursief
*Cursief* of _cursief_
Vetgedrukt
**Vet** of __vet__
Vet en cursief
***Vet en cursief*** of ___vet en cursief___
Genummerde en ongeordende lijsten
Markdown ondersteunt zowel genummerde als ongeordende lijsten.
Ongeordende lijst
- Item 1
- Item 2
- Subitem 1
- Subitem 2
Genummerde lijst
1. Eerste item
2. Tweede item
1. Subitem 1
2. Subitem 2
Hyperlinks in Markdown
Je kunt links maken door de linktekst tussen vierkante haken ([]) te plaatsen en vervolgens de URL tussen ronde haken (()) te plaatsen.
[Linktekst](URL)
Voorbeeld
Bezoek [Markdown Guide](https://www.markdownguide.org/) voor meer informatie.
Afbeeldingen insluiten
Afbeeldingen worden toegevoegd met een uitroepteken (!) gevolgd door de alternatieve tekst (alt text) tussen vierkante haken en de afbeeldings-URL tussen ronde haken.
Voorbeeld
Blokcitations en geneste citations
Blokcitations worden gemaakt met het groter-dan-symbool (>).
> Dit is een blokcitation.
Geneste blokcitations
> Dit is het eerste niveau van citatie.
>> Dit is een geneste blokcitation.
Inline-code en afgeperste codeblokken
Je kunt inline-code toevoegen door deze tussen backticks (`) te plaatsen. Voor codeblokken gebruik je driedubbele backticks (```) voor en na de code.
Inline-code
Gebruik `printf()` om tekst in C af te drukken.
Codeblokken
```python
python def hello_world(): print("Hello, World!")
```
Meer over codeblokken in Markdown - zie aparte post: Gebruik van Markdown-codeblokken. De taalidentificatie mermaid is een opvallende uitzondering — deze activeert diagramrendering in plaats van syntaxhighlighting, waardoor een plat afgeperst blok wordt omgezet in een flowchart of sequentiediagram. De Mermaid-diagrammen Quickstart behandelt de volledige diagramsyntaxis, van flowcharts tot ER-diagrammen.
Horizontale regels (Scheidingselementen)
Horizontale regels worden gemaakt met drie of meer streepjes (—), asterisks (***) of underscores (___).
---
Tabellen
Tabellen in Markdown worden gemaakt met pipes (|) en streepjes (-).
Voorbeeld
| Koptekst 1 | Koptekst 2 |
|------------|------------|
| Cel 1 | Cel 2 |
| Cel 3 | Cel 4 |
Voor uitlijningsopties, formatting van meerdere kolommen en GFM-specifieke functies, zie de Tabellen in Markdown: Complete Gids.
Takenlijsten (Selectievakjes)
Takenlijsten zijn een speciaal type lijst waarmee je selectievakjes kunt maken.
Voorbeeld
- [x] Voltooide taak
- [ ] Onvoltooide taak
Doorhalen van tekst
Doorhalen van tekst wordt gemaakt met dubbele tildes (~~).
~~Dit is doorgehaalde tekst.~~
Tekst markeren
Het markeren van tekst wordt niet standaard ondersteund in Markdown, maar sommige renderers ondersteunen dit met de ==-syntaxis.
Voorbeeld
==Dit is gemarkeerde tekst.==
Subscripten en superscripten
Subscripten worden gemaakt met een caret (^) voor de tekst, en superscripten worden gemaakt met een tilde (~) voor de tekst.
Voorbeeld
H~2~O is water.
E = mc^2
Wiskundige vergelijkingen (LaTeX-syntaxis)
Wiskundige vergelijkingen kunnen worden toegevoegd met LaTeX-syntaxis binnen dollartekens ($).
Voorbeeld
$$ E = mc^2 $$
Speciale tekens ontsnappen
Om speciale tekens te ontsnappen, gebruik je een backslash ().
Voorbeeld
\*Cursief\* of \_cursief\_
Deze uitgebreide cheat sheet dekt de essentiële Markdown-syntaxis die je nodig hebt om goed opgemaakte documenten te maken. Voor geavanceerde functies en aanpassingen, raadpleeg de documentatie van de specifieke renderer of aanvullende bronnen. Als je Hugo gebruikt, is de Hugo Commandos Cheat Sheet een handige referentie.
Markdown is ook het standaardopslagformaat voor zelfgehoste wikis en kennissystemen. DokuWiki gebruikt een Markdown-vriendelijke platte-tekstbenadering voor persoonlijke en team-kennisbases. Voor AI-geassisteerde kennissystemen gebouwd op Markdown-pagina’s, legt LLM Wiki uit waarom de portabiliteit en diffabiliteit van het formaat het de juiste basis maakt voor gecompileerde kennis.
