> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md).
# Hoe in Markdown op Overleaf te schrijven
**Bijwerking na publicatie** (toegevoegd op 13 mei 2017): We zijn Vít Novotný, de auteur/onderhouder van het `markdown` pakket, dankbaar dat hij ons schreef met nuttige feedback over het oorspronkelijke artikel. We zijn blij deze bijgewerkte versie te publiceren, waarin zijn advies en suggesties zijn meegenomen en opgenomen.
### Hè, wat?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) is een lichtgewicht opmaaktaal (snap je 'm? 😉) waarmee je iets in platte tekst kunt schrijven met een paar *zeer* eenvoudige regels, en het vervolgens kunt omzetten naar opgemaakte uitvoer, bijvoorbeeld HTML. Het is erg populair onder softwareontwikkelaars en programmeurs, juist vanwege de eenvoud ervan (en als ik eraan mag toevoegen: ook perfect voor het maken van aantekeningen!).
Bijvoorbeeld, om een snelle boodschappenlijst te schrijven:
```
# Boodschappenlijst
*Vergeet niet* zoveel mogelijk in te slaan tijdens de komende [aanbiedingen](http://acme-marg.com)!
## Voedsel
- baked beans
- spaghetti
## Schrijfwaren
- schrijfblok
- potloden
```
En je krijgt als HTML-uitvoer, met behulp van een tool zoals [pandoc](http://pandoc.org/):
```html
Boodschappenlijst
Vergeet niet zoveel mogelijk in te slaan tijdens de komende aanbiedingen!
Voedsel
Schrijfwaren
```
Mooi en eenvoudig! Je kunt andere syntaxis voor Markdown vinden [hier](https://daringfireball.net/projects/markdown/syntax).
### Dus wat betekent dit voor mij?
Veel LaTeX-gebruikers zijn tevreden met hun prachtig opgemaakte LaTeX-documenten, maar kunnen het niet helpen om een vleugje jaloezie te voelen tegenover Markdown-gebruikers—omdat LaTeX-opmaak *kan* soms nogal uitgebreid wordt. Ja, lijsten, we kijken naar *jullie*...
Het goede nieuws is dat het fantastische nieuwe [`markdown` LaTeX-pakket](https://ctan.org/pkg/markdown) je in staat stelt om Markdown-syntaxis in je LaTeX-documenten te schrijven (oftewel eenvoudigere invoer) en toch prachtig opgemaakte pdf's te krijgen! Het enige wat je hoeft te doen is het `markdown` pakket in je document laden, en je Markdown-materiaal insluiten binnen een `markdown` omgeving:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Boodschappenlijst
*Vergeet niet* zoveel mogelijk in te slaan tijdens de komende [aanbiedingen](http://acme-marg.com)!
## Voedsel
- baked beans
- spaghetti
## Schrijfwaren
- schrijfblok
- potloden
\end{markdown}
\end{document}
```
Of als je je Markdown-materiaal liever in een `*.md` bestand:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Handig! Dit zal ontwikkelaarstypes waarschijnlijk erg blij maken, omdat ze nu gewoon hun `.md` documentatie!
### Kan ik nog steeds LaTeX-commando's gebruiken als ik Markdown schrijf?
Ja, je kunt nog steeds LaTeX-commando's in je Markdown-materiaal gebruiken! Geef gewoon de `hybride` optie door aan `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- schrijfblok (het soort met de grote $E=mc^2$ op de kaft)
```
### Hoe kan ik letterlijke tekens zoals '#' en '\_' (underscores) gebruiken?
#### Een '#' typen
Je kunt het '#' teken niet typen *binnen de `markdown` omgeving*. Zelfs niet `\#` zal werken. Je moet een commando definiëren zoals `\newcommand{\texthash}{\#}`, en gebruik vervolgens `\texthash` in je `markdown` omgeving. Evenzo voor underscores, vooral wanneer er meer dan één op dezelfde regel staan, bijvoorbeeld `$y = m_1 + n_2$`. Soms kan het gemakkelijker zijn om de huidige `markdown` omgeving te beëindigen en problematische regels in de gewone LaTeX-modus te schrijven, en dan een andere `markdown` omgeving te starten.
#### Het typen van '\_' (underscore) en '\`' (backtick)
**Update** (toegevoegd op 13 mei 2017): Sinds `markdown` versie 2.5 kun je instellen `underscores = false` en `codeSpans = false` om underscores en backticks uit te schakelen. Hierdoor is het mogelijk om wiskundige subscripten en aanhalingstekens in hybride modus te schrijven zonder te escapen. We hebben asterisken voor nadruk, dus het enige dat echt verloren gaat, zijn inline codevoorbeelden. Dank je, Vít, voor de tip!
#### Omgevingen om te vermijden...
En hoewel je backticks kunt gebruiken om inline-verbatim te schrijven, of de regel met vier spaties kunt laten inspringen voor een verbatimblok, gebruik geen `lstlisting` noch `minted` LaTeX-omgevingen binnen `markdown` omgevingen. Doe het gewoon niet.
#### HTML gebruiken in een Markdown-omgeving
En nee, je kunt HTML niet gebruiken binnen de LaTeX `markdown` omgeving (ook al is dit iets wat je in gewone Markdown vaak doet). Sorry.
**Update** (toegevoegd op 13 mei 2017): Sinds `markdown` v2.3 is er een `html` optie die HTML-tags niet letterlijk weergeeft als ze aanwezig zijn in je Markdown-materiaal, maar de inhoud van de tags ook niet echt opmaakt—oftewel `Hallo!` zal gewoon Hallo! in normale opmaak weergeven. Maar HTML-entiteiten zoals `©` worden weergegeven als ©. Dank aan Vít voor het opmerken hiervan.
### Voorgestelde opties voor het Markdown-pakket
Een set `markdown` pakketopties die je misschien nuttig vindt, is:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Met die opties kun je gebruikmaken van
* Markdown-syntaxis voor voetnoten (zoals `[^1]`);
* definitielijsten en `#` voor genummerde lijsten;
* "echte" ellipsen (…).
Hier is een [volledig voorbeeld](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) in de Overleaf-galerij, en hier is [nog een](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperlinks en voetnoten: hoe?
In het Overleaf-voorbeeld is de hyperlink een voetnoot. Hoe maak ik er een hyperref-hyperlink van?
`markdown` is aanpasbaar, zodat je kunt definiëren hoe verschillende elementen moeten worden weergegeven. Door deze aan je preamble toe te voegen, doe je precies dat:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Update** (toegevoegd op 13 mei 2017): `rendererPrototypes` werd in de eerste versie gebruikt. Normale gebruikers wordt aangeraden om `renderers` voor hun eigen definities te gebruiken, aangezien `rendererPrototypes` bedoeld is voor pakketmakers om standaardwaarden te leveren. Als je `rendererPrototypes`, loop je het risico dat een ander pakket je instellingen overschrijft. Dank aan Vít voor het opmerken hiervan!
### Afbeeldingen opnemen (bijgewerkt op 8 november 2022)
* **Opmerking**: Het volgende voorbeeld gebruikt een grafisch bestand (`example-image.pdf`) geleverd door het `mwe` pakket. Deze grafische bestanden worden verspreid door TeX Live en zijn dus opgeslagen op de servers van Overleaf, waardoor ze beschikbaar zijn als afbeeldingsplaatsaanduidingen, zoals in het onderstaande voorbeeld.
Afbeeldingen kunnen in markdown worden opgenomen door markup in het volgende formaat te schrijven:
```latex
```
Hopelijk beschrijven de parameternamen `alt-tekst`, `bestandsnaam` en `"afbeeldingsbijschrift"` wat ze doen. Hier is een voorbeeld om ze te demonstreren:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Het mwe-pakket biedt voorbeeldafbeeldingen. Het laden ervan is
% niet essentieel omdat die afbeeldingen in het zoekpad van LaTeX staan.
% Hier laden we het voor de duidelijkheid in dit voorbeeld.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Dit voorbeeld laat zien hoe je een grafisch bestand importeert. Hier gebruiken we een
voorbeeldafbeelding die wordt geleverd door het `mwe`-pakket.
% Gebruik \setkeys{Gin} als je de weergavegrootte van een afbeelding moet wijzigen
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Dit voorbeeld levert de volgende uitvoer op:
#### Opmerking over de afbeeldingsbreedte
Zoals de meeste pakketten `markdown` laadt andere pakketten, waaronder [`keyval`](https://ctan.org/pkg/keyval?lang=en) en [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), om gebruik te maken van de commando's en functies die ze bieden. Hier wordt de afbeeldingsbreedte ingesteld met behulp van het `\setkeys` commando, dat wordt geleverd door `keyvals`. `Gin` is een "familie" van sleutels gedefinieerd door de `graphicx` pakket niet te gebruiken.
* **Opmerking**: Omdat een LaTeX-commando, hier `\setkeys`, wordt gebruikt *binnen* het `markdown` omgeving, is de `hybride` optie van het markdown-pakket vereist.
#### Het wijzigen van float-plaatsingsaanduidingen (meer geavanceerd)
De Markdown-syntaxis voor het opnemen van figuren laat je niet rechtstreeks de float-plaatsingsaanduidingen opgeven, maar je kunt ze aanpassen door opnieuw te definiëren hoe de figuur wordt weergegeven:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Voor meer informatie, raadpleeg de [Markdown-documentatie](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Kun je tabellen maken met Markdown in LaTeX? 😀
Helaas niet. Tabellen worden alleen ondersteund in [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) alleen, en het LaTeX `markdown` pakket ondersteunt het momenteel niet.
**Update** Op basis van een tip van Vít is het mogelijk om de `contentBlocks` syntaxuitbreiding sinds versie 2.4 te gebruiken, of de `inputFencedCode` renderer aan te passen om snel wat tekst in CSV-stijl om te zetten naar een tabel.
### Meer Markdown-pakketextra's...?
Zoals eerder genoemd, is het een coole manier om aantekeningen te maken, en in combinatie met een aantal mooie LaTeX-documentklassen of pakketopstellingen, kun je aan het eind van een college zelf meteen een prachtig notitieboek hebben. Bijvoorbeeld, je zou het kunnen gebruiken met de [Tufte-klassen](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
En de korte en eenvoudige syntaxis die het schrijven van lijsten veel handiger maakt, betekent dat we nu een *heel snelle* manier om [Beamer-presentaties](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) en [posters](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Veel plezier!
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.