> 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/32-markdown-into-latex-with-style.md). # Markdown naar LaTeX met stijl **Update na publicatie** (13 mei 2017): We zijn Vít Novotný, de auteur/beheerder van het `markdown` pakket, dankbaar dat hij ons heeft geschreven met nuttige feedback over het oorspronkelijke artikel. We publiceren graag deze bijgewerkte versie, waarin zijn advies en suggesties zijn verwerkt. ### Inleiding Enige tijd geleden waren we verheugd over de release van het [`markdown-pakket`](http://www.ctan.org/pkg/markdown) waarmee het mogelijk werd markdown-syntaxis in LaTeX-documenten te schrijven — en vierden dat met een artikel getiteld [Hoe je in Markdown schrijft op Overleaf](/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md) dat bedoeld was om enkele van de ondersteunde syntaxis te demonstreren. **Vergeet niet**: Je moet je `.tex` bestanden compileren met de `--shell-escape` optie om het te laten werken op lokale LaTeX-installaties — Overleaf doet dat automatisch voor je. Houd er rekening mee dat de meeste portals voor het indienen van artikelen `--shell-escape`niet inschakelen — tenzij je alleen de uitvoer-PDF van je manuscript mag uploaden, kunnen je LaTeX-bestanden met markdown mogelijk niet succesvol compileren wanneer ze worden verwerkt door het indieningssysteem van de uitgever. Een van de ideeën die werden aangestipt in het [eerdere artikel](/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md) is dat een combinatie van markdown en LaTeX een prachtige scheiding tussen inhoud en stijl mogelijk maakt. Auteurs (vooral degenen die al vertrouwd zijn met markdown) zouden met een veel beknoptere syntaxis kunnen werken (met enkele kanttekeningen), terwijl ze nog steeds toegang hebben tot alle voordelen van LaTeX-pakketten en -sjablonen om de opmaak en vormgeving te verzorgen. Dat [eerdere artikel](/latex/nl/diepgaande-artikelen/30-how-to-write-in-markdown-on-overleaf.md) gaf enkele voorbeelden van het gebruik van markdown in [Beamer-presentaties](https://www.overleaf.com/read/dnrwnjrpjjhw) en [posters](https://www.overleaf.com/read/jtbgmmgqrqmh): vandaag gaan we kijken naar nog meer leuke en spannende opmaakmogelijkheden! ### Markdown gebruiken in opgemaakte LaTeX-sjablonen Naast de bovenstaande voorbeelden kun je markdown in bijna alle sjablonen gebruiken. Hier zijn een paar snelle voorbeelden: * De [Legrange oranje boek](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) sjabloon * De [Tufte-geïnspireerde hand-out](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) sjabloon * Dit [zeer mooi artikel-sjabloon](https://www.overleaf.com/read/xfsrpsmdtqvt) van Thiago Je merkt misschien dat twee hiervan artikel-sjablonen zijn en één een boeksjabloon is. De [`markdown-pakket`](http://www.ctan.org/pkg/markdown) detecteert of de `\chapter` opdracht beschikbaar is voor gebruik in een bepaald LaTeX-document en zal de kopregel van het eerste niveau `markdown` regel laten weergeven als `\chapter` of `\section` passend. ### Razendsnelle hand-outs: markdown + pocketmod Vanaf de eerste keer dat ik over markdown hoorde, leek het me een snelle en handige manier om notities te maken: het weerspiegelt hoe ik misschien aantekeningen zou krabbelen op papiertjes of post-its — vooral met de syntaxis voor opsommingstekens en genummerde lijsten. Toen ik voor het eerst de [PocketMod-sjabloon](https://www.overleaf.com/read/nqbhpnrkskrx) in 2015 maakte, verlangde ik naar een manier om markdown in LaTeX te schrijven zodat ik PocketMods kon maken *meestal* markdown omdat het… passend aanvoelde. Aantekeningen maken in een eenvoudige syntaxis in kleine gevouwen boekjes, maar met mooie typografie — sommige mensen noemen PocketMods "zines" omdat het kleine boekjes van 8 pagina's zijn die je van één vel A4-papier kunt maken. En dus was het inderdaad mogelijk! Daarmee is het vrij eenvoudig om snel een [mini-boekje voor een weekplanner](https://www.overleaf.com/read/zfzcxygqwqsq) of een klein [prentenboek](https://www.overleaf.com/read/rppnsfgnrhsf). Ja, mijn dochter vond het vermakelijk om een prentenboek te zien dat uit haar eigen tekeningen was gemaakt… nou ja, voor wel 10 minuten! De [`markdown-pakket`](http://www.ctan.org/pkg/markdown) laat je aanpassen hoe elke markdown-syntaxis naar LaTeX wordt omgezet, dus ik heb de standaard `![](img_file "bijschrift")` syntaxis opnieuw gedefinieerd om het bijschrift onder het afbeeldingsbestand te plaatsen (zonder voorvoegsel "Figuur" of nummering), en vervolgens een pagina-einde ingevoegd. Dat maakt het nog makkelijker om het prentenboek te maken. Hier is een video die laat zien hoe je het boekje vouwt: {% embed url="" %} ### Eenvoudige receptboekjes Als je erover nadenkt, bestaat een recept uit lijsten: een lijst met ingrediënten, een lijst met bereidings- of kookinstructies, en misschien een lijst met notities (kooktijd, aantal porties enz.). Dus in plaats van dit te schrijven: ```latex \begin{enumerate} \item Doe eerst dit \item Doe daarna dat ... \end{enumerate} ``` Ik zou het zeker waarderen als ik dit zou kunnen schrijven: ``` #. Doe eerst dit #. Doe daarna dat ``` En hetzelfde geldt voor de ingrediënten: ``` - 2 eieren - snufje zout ``` Om dus eenvoudig een snel recept te maken kunnen we dit schrijven: ``` # Roerei Kooktijd : 5 minuten Porties : 1 ## Ingrediënten - 4 eieren - 1 tl boter - 1/4 kopje melk - zout, peper (naar smaak) ## Instructies #. Klop eieren, melk... #. Verhit boter in de pan... #. ... ``` Hmm, dat ziet er veelbelovend uit. Een paar van ons bij Overleaf (en onze families) droegen onze favoriete snelle recepten bij (ideaal voor beginnende koks) en ik stelde een [snel-receptensjabloon](https://www.overleaf.com/read/gscqdhnwzsfg) samen dat je met markdown kunt schrijven *en* en omzetten in een mini-boekje. [![A recipe booklet produced on Overleaf using markdown](/files/2d93f91217e5c6c3522153b92d38fd9e67af79d5)](https://www.overleaf.com/read/gscqdhnwzsfg) Nu komt er nog wat leuks bij. Onder de motorkap is dit nog steeds LaTeX, dus we kunnen doorgaan met het opmaken van de verschillende elementen — sectiekoppen, opsommingstekens, lettertypes en zo verder — met de gebruikelijke LaTeX-trucs. Toen sloeg ik behoorlijk door en kwam ik met *drie* "thema's" voor de `simple-recipe` klasse! ### Bonus 1: Enkele kanttekeningen bij het gebruik van het markdown-pakket * SyncTeX zal niet helemaal werken. Op Overleaf betekent dit dat de bewerkingen "positie in preview" en "klik in preview om naar bron te springen" niet zullen werken in de `markdown` gebieden. * `\\` verliest zijn normale betekenis: de gebruikelijke "twee spaties gevolgd door een nieuwe regel" `markdown` truc werkt hier niet, omdat spaties aan het einde worden verwijderd door de Lua-parser, zoals gedocumenteerd in de [`markdown` pakkettendocumentatie](http://texdoc.net/pkg/markdown). `\newline` zal wel werken. * Pas op voor meerdere onderstrepingstekens op dezelfde regel — dat kan een probleem zijn als: * je met veel subscripts werkt in je vergelijkingen (tip: verlaat in zulke gevallen de `markdown` omgeving); * je graag underscores gebruikt in je BibTeX-sleutels. Je kunt `underscores=false` instellen met de nieuwste `markdown-pakket` bestanden om subscript-underscores te laten werken, maar het werkt nog steeds niet met underscores in BibTeX-sleutels. **Update** (13 mei 2017): Underscores in BibTeX-sleutels werken met `markdown` v2.5.2 en hoger — dank je, Vít! * Je zult wat moeite hebben om een letterlijk hekje weer te geven, want zelfs `\#` zal niet werken! Ik definieer meestal een nieuw commando en gebruik dat in plaats daarvan. ### Bonus 2: Nieuwe functies in het bijgewerkte markdown-pakket `markdown` v2.4 en later voegden ondersteuning toe voor een aantal echt mooie syntaxis: * **Ingesloten voetnoot-syntaxis**: `...^[dit is de voetnoot]` (vereist de `inlineFootnotes` optie) * **Citaten:**`[@smith1990]` (vereist de `citaten` optie; pas ook op voor underscores in je BibTeX-sleutels!) * **Omlijnde code**: Je kunt ofwel tildes gebruiken `~` of backticks `` ` `` als de omkadering. ``` ~~~~ int main() { cout << "Hallo wereld!"; return 0; } ~~~~ ``` Als je deze nieuwe functies wilt gebruiken, zorg er dan voor dat je bijgewerkte versies uploadt van `markdown.lua`, `markdown.tex` en `markdown.sty` naar je project — of je kunt gewoon een nieuw project maken vanuit [dit sjabloon](https://www.overleaf.com/read/whdrnpcpnwrm). --- # 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/32-markdown-into-latex-with-style.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.