Markdown bestaat om een **eenvoudige en leesbare manier** te bieden om tekst op te maken zonder gebruik te maken van ingewikkelde opmaakcodes of grafische editors. Het werd in 2004 ontwikkeld door John Gruber en Aaron Swartz met als doel een makkelijke syntax te creëren die zowel gemakkelijk te schrijven als om te zetten is naar HTML. Het voordeel van Markdown is dat het lichtgewicht is, goed leesbaar blijft in platte tekst en eenvoudig kan worden geconverteerd naar andere formaten zoals HTML, PDF of Word. Dit maakt het ideaal voor notities, blogs, documentatie en code-documentatie, zonder dat je afgeleid wordt door complexe opmaakopties. # Syntax ## Smaakjes Er zijn verschillende markdown flavors, zie het als verschillende dialecten van markdown taal. Dit kan het verwarrend maken. Er bestaan [overzichten](https://www.markdownguide.org/tools/) waarin staat wat die specifieke applicatie ondersteund maar je kan altijd in de documentatie van die applicatie kijken ## Titels In Markdown: ```markdown # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 ##### Heading 5 ###### Heading 6 ``` En dat ziet er (afhankelijk van opmaak) dan zo uit: ![[Pasted image 20250221113335.png|200]] > [!info] Best practice > - Het is belangrijk dat je altijd een spatie doet na de laatste `#`. > - Voor een goede compatibiliteit is het aan te raden altijd een lege regel vóór en na een heading te plaatsen. ## Paragraaf en regeleinde Een paragraaf word bepaald door het plaatsen van een witregel ```markdown Dit is de eerste paragraaf. Dit is de tweede paragraaf. ``` Een regeleinde is iets moeilijker leesbaar doordat je aan het eind van een regel 2 spaties plaatst. Dit noemen ze ook wel 'trailing whitespace' en dit word niet door alle editors gewaardeerd en ook is dit niet te zien in de meeste editors ```markdown Dit is een regel Dit is tekst na een regeleinde ``` In [[Obsidian]] is er daarom een optie 'strict line breaks' • **Strict line breaks AAN** (standaard Markdown-gedrag): Je moet handmatig **twee spaties** toevoegen om een regeleinde te forceren. • **Strict line breaks UIT**: Elke line break in de editor wordt ook als een nieuwe regel weergegeven in de leesmodus. ## Tekstopmaak ### Dikgedrukt (Bold) Je hebt 2 opties: ```markdown Deze tekst is **bold** Deze tekst is ook __bold__ ``` Sommige editors hebben moeite met de underscore variant en daarom zou ik aanraden de asterisks variant te gebruiken ### Schuigedrukt (italix) Ook hier heb je twee opties: ```markdown Deze tekst is *italic* Deze tekst is ook _italic_ ``` Sommige editors hebben moeite met de underscore variant en daarom zou ik aanraden de asterisks variant te gebruiken ### Dikgedrukt en italic combineren Voor extra belangrijke tekst ```markdown Erg ***belangrijke*** tekst Erg ___belangrijke___ tekst Erg *__belangrijke__* tekst Erg _**belangrijke**_ tekst ``` ## Links | Kenmerk | WikiLinks | Markdown-links | | ------------ | ----------------------------------------- | ------------------------------------------ | | **Syntax** | `[[Notitie]]` | `[Tekst](Bestand.md)` | | **Gebruik** | Interne links tussen notities | Zowel interne als externe links | | **Platform** | Werkt vooral in Obsidian | Universeel in Markdown-editors | | **Voordeel** | Sneller en eenvoudiger voor interne links | Flexibeler en compatibel met meer systemen | In [[Obsidian]] gebruik je `[[link]]` voor interne links en `[tekst](url)` voor externe links. # Markdown Editors Voorbeelden van editors die volledig markdown ondersteuning aanbieden: - [[Obsidian]] - [Simplenote](https://www.markdownguide.org/tools/simplenote/) - [Notable](https://www.markdownguide.org/tools/notable/)  - [[Bear]] - [Joplin](https://www.markdownguide.org/tools/joplin/)  - [Boostnote](https://www.markdownguide.org/tools/boostnote/) Er zijn ook editors die deels markdown gebruiken of hun eigen [[#Syntax]] variant hebben, denk bijvoorbeeld aan [[DayOne]] en [[Craft.do]] Sommige editors kunnen een *live* vertoning geven van de opmaak passend bij **markdown**. Een goede bron voor het vinden van applicaties die markdown ondersteunen is [Tools \| Markdown Guide](https://www.markdownguide.org/tools/) # Bronnen [Markdown Guide](https://www.markdownguide.org)