Markdown is een lichte opmaaktaal die wordt gebruikt om eenvoudig leesbare en schrijfbare tekst te maken, die kan worden geconverteerd naar HTML. In Neoforce is Markdown een krachtig hulpmiddel om content te creëren die zowel eenvoudig te beheren als visueel aantrekkelijk is. Dit artikel biedt een uitgebreide gids over het gebruik en het doel van Markdown in Neoforce.

Wat is Markdown?

Markdown is ontworpen om de leesbaarheid en toegankelijkheid van platte tekst te verbeteren zonder dat complexe HTML-code nodig is. Het is ideaal voor het schrijven van documentatie, notities, wikipagina's en meer. Markdown converteert eenvoudig leesbare tekst in gestructureerde HTML, waardoor het zeer geschikt is voor gebruik in content management systemen zoals Neoforce.

Voordelen van Markdown in Neoforce

• Eenvoudig te gebruiken: Markdown is eenvoudig te leren en te gebruiken, zelfs voor niet-technische gebruikers.
• Snelle content creatie: Gebruikers kunnen snel content maken zonder tijd te besteden aan het leren van complexe opmaakcodes.
• Responsieve weergave: Markdown-inhoud is volledig responsief en wordt goed weergegeven op verschillende apparaten.
• Ondersteuning voor samenwerking: Markdown maakt het eenvoudig voor meerdere gebruikers om samen te werken aan dezelfde documentatie of wikipagina's.

Markdown in Neoforce gebruiken

In Neoforce kun je Markdown gebruiken in verschillende modules zoals:

• Tijdlijn: Breid je reacties en opmerkingen uit met extra opmaak, screenshots, schermopnamens en bijvoorbeeld Youtube-video's!. Verder kun je andere gebruikers ook taggen.
• Wiki: Maak gedetailleerde documentatiepagina's met opmaak, links, afbeeldingen en tabellen. De koppen worden automatisch herkend en gebruikt in de inhoudsopgave van het artikel!
• Nieuwsberichten: Formatteer je nieuwsartikelen op een aantrekkelijke manier.
• Formulieren: Gebruik Markdown om instructies en beschrijvingen te verfraaien.

Voor het merendeel van de functies hier beschreven hoef je niet perse de genoemde codes te gebruiken. Door middel van de WYSIWYG-editor wordt het gebruik gemakkelijker gemaakt.

Basis Markdown-syntaxis

Hier volgt een overzicht van enkele veelgebruikte Markdown-elementen die je in Neoforce kunt gebruiken:

Koppen

Gebruik het # symbool voor koppen. Meer # symbolen betekenen een lagere kopniveaus.

# Dit is een H1 kop
## Dit is een H2 kop
### Dit is een H3 kop

In de Wiki, zowel in het behandelaarsgedeelte als in het klantenportaal zal op basis van deze koppen vervolgens automatisch een inhoudsopgave worden gegenereerd.

Gebruikers kunnen klikken en worden naar de bijhorende alinea gestuurd.

Vet en cursief

Gebruik ** voor vetgedrukte tekst en * voor cursieve tekst.

Code

**Dit is vetgedrukte tekst**

*Dit is cursieve tekst*

Lijsten

Gebruik - of * voor ongenummerde lijsten en cijfers voor genummerde lijsten.

Code

- Ongeordende lijst item 1
- Ongeordende lijst item 2

1. Geordende lijst item 1
2. Geordende lijst item 2

Links en afbeeldingen

Gebruik [tekst](url) voor links en ![alt tekst](url) voor afbeeldingen.

Code

[Dit is een link naar Neoforce](https://www.neoforce.com)

![Neoforce logo](https://www.neoforce.com/logo.png)

Video's en Youtube

Vanaf versie 24.07 kun je ook video's embedden. Dit doe je op de volgende manier:

Code

Zelf gehoste video's (in Neoforce)

![video](https://www.neoforce.com/voorbeeld.mp4)

Youtube

![video](https://www.youtube.com/watch?v=EzjCgmlHfo4)

Tabellen

Tabellen kunnen worden gemaakt met behulp van streepjes en pijpen.

| Kolom 1 | Kolom 2 |
| ------- | ------- |
| Rij 1   | Data    |
| Rij 2   | Data    |

Horizontale streep

Ook kun je een horizontale streep gebruiken.

Voorbeeld:

Hiervoor gebruik je 4 keer het 'min'-teken, zoals hieronder:

----

Geavanceerde Markdown-functies in Neoforce

Naast de basisfuncties ondersteunt Neoforce ook enkele geavanceerde Markdown-functies om de gebruikerservaring te verbeteren.

Tekst- en achtergrondkleuren

Ook een aangepast tekst- en/of achtergrondkleur is mogelijk. Hiervoor gebruiken we een syntax die lijkt op CSS. Hieronder enkele voorbeelden:

Code

{Rood zonder achtergrond}(color: red;)
{Gele achtergrond}(background-color: yellow)
{Achtergrond met gekleurde tekst}(color: white; background-color: black)

Voorbeeld
Rood zonder achtergrond
Gele achtergrond
Achtergrond met gekleurde tekst

Naast de namen (red, yellow, white, black etc) is er ook ondersteuning voor hexadecimale kleurcodes.

Inline code

Voor inline code gebruik je enkele backticks.

Code

`<inline code>`

Voorbeeld
<inline code>

Citeren

Gebruik > om citaten toe te voegen.

Code

> Dit is een citaat

Voorbeeld

Dit is een citaat