> 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/kennisbank/166-writing-markdown-in-latex-documents.md).

# Markdown schrijven in LaTeX-documenten

## Inleiding

Om markdown in een LaTeX-document te gebruiken moet je het [`markdown` pakket](https://www.ctan.org/pkg/markdown) in de preambule van je document laden:

```latex
\usepackage[settings]{markdown}
```

waar `[settings]` is een *optionele* set parameters die worden gebruikt om specifieke pakketfuncties te configureren of in te schakelen. Raadpleeg de `markdown` pakket [documentatie](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) voor een [beschrijving van de pakketparameters (opties)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Dit artikel geeft kort een overzicht van zowel *inline* markdown—geschreven binnen je document—als het importeren van *externe* markdown die in een tekstbestand is opgenomen.

* **Opmerking**: Over het algemeen moet het gebruik van markdown binnen een LaTeX-document worden gezien als een aanvullende en handige optie om bepaalde elementen van de inhoud van je document te schrijven, niet als een alternatieve syntax die LaTeX volledig vervangt.

## Externe markdown-bestanden gebruiken

Gebruik het commando

```latex
\markdownInput{filename}
```

om het markdown-bestand `filename`.

Het volgende voorbeeld voegt een bestand toe met de naam `example.md`. Gebruik de link onder de code-overzichten om ze te openen als een Overleaf-project:

**`main.tex`**

```latex
\documentclass{article}
\title{Het markdown-pakket gebruiken}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% voorbeeld.md

# Ik ben een markdown-bestand.

En ik kan *nadruk* toepassen.
## Met subkoppen

> Blokcitaten zijn
> zo geschreven.
>
> Ze kunnen meerdere alinea's beslaan,
> als je dat wilt.

Gebruik 3 streepjes voor een gedachtestreepje. Gebruik 2 streepjes voor
bereiken (bijv., "het staat allemaal in hoofdstukken 12--14").
Drie puntjes ... worden omgezet in een ellips
(mits je de smartEllipses-optie opneemt
in je preambule). Unicode wordt ondersteund.
```

[Open deze bestanden als een Overleaf-project.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BUsing+the+markdown+package%7D%0A%5Cusepackage%5BsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5CmarkdownInput%7Bexample.md%7D%0A%0A%5Cend%7Bdocument%7D\&snip_name\[]=example.md\&snip\[]=%25%25+example.md%0A%0A%23+I%27m+a+markdown+file.%0A%0AAnd+I+can+do+%2Aemphasis%2A.%0A%23%23+With+sub-headers%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AUse+3+dashes+for+an+em-dash.+Use+2+dashes+for+%0Aranges+%28ex.%2C+%22it%27s+all+in+chapters+12--14%22%29.+%0AThree+dots+...+will+be+converted+to+an+ellipsis+%0A%28provided+you+include+the+smartEllipses+option+%0Ain+your+preamble%29.+Unicode+is+supported.\&main_document=main.tex)

Dit voorbeeld levert de volgende uitvoer op:

![Afbeelding die de uitvoer van het markdown-pakket laat zien](/files/fd747e282fb45bcfaa58c19ec0d5d31944b658a8)

## Inline markdown gebruiken

Gebruik de `markdown` omgeving:

```latex
\begin{markdown}
...je markdown
komt hier...
\end{markdown}
```

om inline markdown te schrijven, zoals gedemonstreerd in het volgende voorbeeld:

```latex
\documentclass{article}
\usepackage[hashEnumerators,smartEllipses]{markdown}
\begin{document}

Inline markdown gebruiken:

\begin{markdown}
Een h1-kop
============

Alinea's worden gescheiden door een lege regel.

2e alinea. *Cursief*, **vet** en `monospace`. Opgelijste lijsten
zien er als volgt uit:

* deze
* die
* de andere

> Blokcitaten zijn
> zo geschreven.
>
> Ze kunnen meerdere alinea's beslaan,
> als je dat wilt.

Een h2-kop
------------

Hier is een genummerde lijst (gebruik de optie `hashEnumerators` als je hekjestekens wilt gebruiken):

#. eerste item
#. tweede item
#. derde item

\end{markdown}
\end{document}
```

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%2CsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0AUsing+inline+markdown%3A%0A%0A%5Cbegin%7Bmarkdown%7D%0AAn+h1+header%0A%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%0A%0AParagraphs+are+separated+by+a+blank+line.+%0A%0A2nd+paragraph.+%2AItalic%2A%2C+%2A%2Abold%2A%2A%2C+and+%60monospace%60.+Itemized+lists%0Alook+like%3A%0A%0A%2A+this+one%0A%2A+that+one%0A%2A+the+other+one%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AAn+h2+header%0A------------%0A%0AHere%27s+a+numbered+list+%28use+%60hashEnumerators%60+option+if+you+want+to+use+hashes%29%3A%0A%0A%23.+first+item%0A%23.+second+item%0A%23.+third+item%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![Voorbeeld van in Overleaf opgemaakte inline markdown](/files/b97fdf793c59bc408a5b6da2fbc51d917c3475a5)

## Functies en opties van het markdown-pakket

Hier verkennen we enkele van de [functies en opties](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) die worden aangeboden door het `markdown` pakket.

### Code opnemen in markdown

Er zijn twee mechanismen voor het weergeven van codefragmenten (codeblokken) binnen markdown:

* door elke regel van het blok minstens vier spaties of één tab in te springen, of
* door zogeheten [omkaderde codeblokken](#using-fenced-code-blocks)

#### Codeblokken weergeven met inspringing

In het volgende voorbeeld worden aan het begin van elke coderegel 4 of meer spaties gebruikt—sommige regels gebruiken 6, 8 of 10 spaties, afhankelijk van de benodigde inspringing:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Hier zijn enkele codefragmenten die minstens 4 spaties zijn ingesprongen.
\vspace{6mm}

\begin{markdown}

Hier is een fragment C:

    /* Laat me itereren ... */

    int i;
    for(i=0; i<10; i++)
    {
      do-something(i)
    }

Hier is wat HTML:

    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dit is een kop.</h1>
          <p>Dit is een alinea.</p>
      </body>
    </html>

\end{markdown}
\end{document}
```

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+code+snippets\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0AHere+are+some+code+fragments+indented+by+at+least+4+space+characters.%0A%5Cvspace%7B6mm%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0A%0AHere+is+a+fragment+of+C%3A%0A%0A++++%2F%2A+Let+me+iterate+...+%2A%2F%0A%0A++++int+i%3B%0A++++for%28i%3D0%3B+i%3C10%3B+i%2B%2B%29%0A++++%7B%0A++++++do-something%28i%29%0A++++%7D%0A%0AHere+is+some+HTML%3A%0A%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![Voorbeeld van het opmaken van code via markdown](/files/4d739a906fedc50e058ccad97be670f7738c3593)

#### Omkaderde codeblokken gebruiken

Een omkaderd codeblok wordt gemaakt door ofwel

* drie backticks (` ``` `), of
* drie tildes (`~~~`)

op de regels vóór en na het codeblok te schrijven. Met deze methode hoef je geen regels in te springen, maar je moet wel de `fencedCode` optie in je preambule gebruiken:

```latex
\usepackage[fencedCode]{markdown}
```

Hier is een voorbeeld van het maken van omkaderde codeblokken met 3 backticks (` ``` `):

````latex
\documentclass{article}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

```
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

```
    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dit is een kop.</h1>
          <p>Dit is een alinea.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![Omkaderde codeblokken gebruiken met het markdown LaTeX-pakket](/files/a4f809b150b8f2f7b75d91f78c876b70656aa168)

#### Syntaxmarkering

Omkaderde codeblokken ondersteunen syntaxmarkering door de naam van de taal na de eerste set backticks te schrijven (`` ` ``). Als voorbeeld wordt het volgende blok geïdentificeerd als Javascript door de eerste set backticks te schrijven als ` ``` js `:

````latex
``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```
````

Voor LaTeX kan het `minted` pakket worden gebruikt voor syntaxmarkering, zoals in het volgende voorbeeld te zien is, dat enkele Javascript (` ``` js `) en HTML (` ``` html `):

````latex
\documentclass{article}
\usepackage{minted}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

``` html
    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dit is een kop.</h1>
          <p>Dit is een alinea.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bminted%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60+js%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60+html%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![Syntaxmarkering met minted en markdown](/files/eadf1235bc056455d452775c77a0c9abfff3c13d)

### Lijsten

Eerdere voorbeelden [demonstreren het maken van ongeordende lijsten](#using-inline-markdown) in markdown met behulp van het `*` \*-teken. Geordende lijsten kunnen worden gemaakt met behulp van het `#` #-teken als de `hashEnumerators` optie is opgegeven:

```latex
\usepackage[hashEnumerators]{markdown}
```

Het is ook mogelijk om geneste lijsten te maken, zoals in het volgende voorbeeld wordt gedemonstreerd:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Hier is een genummerde lijst die een geneste lijst bevat:

#. Verzamel eerst deze ingrediënten:

      * wortels
      * selderij
      * linzen

#. Kook wat water.

#. Doe alles in de pan en volg dit algoritme:

        houten lepel vinden
        deksel van de pan halen
        roeren
        pan afdekken
        houten lepel wankel op het handvat van de pan balanceren
        10 minuten wachten
        ga terug naar de eerste stap (of zet de brander uit als je klaar bent)

    Stoot niet tegen de houten lepel, anders valt hij.
\end{markdown}
\end{document}
```

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+nested+list+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AHere+is+a+numbered+list+that+contains+a+nested+list%3A%0A%0A%23.+First%2C+get+these+ingredients%3A%0A%0A++++++%2A+carrots%0A++++++%2A+celery%0A++++++%2A+lentils%0A%0A%23.+Boil+some+water.%0A%0A%23.+Dump+everything+in+the+pot+and+follow+this+algorithm%3A%0A%0A++++++++find+wooden+spoon%0A++++++++uncover+pot%0A++++++++stir%0A++++++++cover+pot%0A++++++++balance+wooden+spoon+precariously+on+pot+handle%0A++++++++wait+10+minutes%0A++++++++goto+first+step+%28or+shut+off+burner+when+done%29%0A%0A++++Do+not+bump+wooden+spoon+or+it+will+fall.%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![Genummerde lijsten maken met het LaTeX markdown-pakket](/files/d1400f37f123e2762c4dda572541a7a97333f028)

### LaTeX opnemen binnen markdown

Als je de `hybride` optie inschakelt, kun je LaTeX-code mengen met Markdown!

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
\begin{document}

\begin{markdown}
Inline wiskundige vergelijkingen kunnen als volgt worden gemaakt: $\omega = d\phi / dt$.
Weergavevergelijkingen kunnen als volgt worden geschreven:

\begin{equation}
I = \int \rho R^{2} dV
\end{equation}

\end{markdown}
\end{document}
```

[Open dit voorbeeld in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+LaTeX+code+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0AInline+math+equations+can+be+created+like+this%3A+%24%5Comega+%3D+d%5Cphi+%2F+dt%24.+%0ADisplay+math+can+be+written+as%3A%0A%0A%5Cbegin%7Bequation%7D%0AI+%3D+%5Cint+%5Crho+R%5E%7B2%7D+dV%0A%5Cend%7Bequation%7D%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dit voorbeeld levert de volgende uitvoer op:

![LaTeX-code gebruiken in markdown](/files/a4dba357a85a0bb6e4a5e10ea4c340e99560ae9a)

### Afbeeldingen opnemen

* **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
![alt-text](file-name "image caption")
```

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}
![Dit is alternatieve tekst om mijn afbeelding te beschrijven.](example-image.jpg "Een voorbeeldafbeelding geleverd door het \texttt{mwe}-pakket.")
\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:

![Laten zien hoe afbeeldingen in markdown te importeren](/files/959e85ab825e42f6f9b456586aa65b20fff30de3)

#### 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.

* **Opmerking**: Omdat een LaTeX-commando, hier `\setkeys`, wordt gebruikt *binnen* het `markdown` omgeving, is de `hybride` optie van het markdown-pakket vereist.

## Verder lezen

Overleaf heeft andere artikelen over het gebruik van markdown gepubliceerd:

* [Hoe je in Markdown schrijft op Overleaf](/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdown naar LaTeX met stijl](/latex/nl/diepgaande-artikelen/32-markdown-into-latex-with-style.md)


---

# 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/kennisbank/166-writing-markdown-in-latex-documents.md?ask=<question>&goal=<endgoal>
```

`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.