Voorbeeldartikel: zo publiceer je op Managementpraat

Dit is een voorbeeldartikel (demo-inhoud). Het laat zien hoe een artikel op Managementpraat.nl werkt, toont alle beschikbare opmaak als levende stijlgids, en mag weg zodra het eerste echte artikel er staat.

Zo werkt het

Een artikel is één markdown-bestand in de map src/content/artikelen/. De bestandsnaam bepaalt het adres: dit bestand heet voorbeeldartikel.md en staat dus op /artikelen/voorbeeldartikel/.

Bovenaan het bestand staan drie regels tussen streepjes:

• title: de titel van het artikel
• description: één zin die het artikel samenvat (staat op de homepage en in Google)
• date: de publicatiedatum als jjjj-mm-dd

Daaronder schrijf je gewoon tekst. Alles wat je daarbij kunt gebruiken staat hieronder, met per onderdeel hoe je het maakt.

Koppen (dit is een H2)

Een kop op dit niveau maak je met ## aan het begin van de regel. Dit is het gewone tussenkopje dat een artikel in delen knipt; ook “Zo werkt het” hierboven is zo’n H2. Daaronder zijn er nog twee kleinere niveaus:

Een subkop daaronder (dit is een H3)

Met ### maak je een subkop, een stap kleiner. Handig als een onderwerp binnen een deel nog een eigen kopje verdient.

Het kleinste kopje (dit is een H4)

Met #### maak je het kleinste kopje. Dieper dan dit gaat de site niet; als je dit nodig hebt, is het artikel misschien toe aan een tweede deel.

Tekst en nadruk

Een woord vetgedrukt maak je met twee sterretjes, een woord cursief met één sterretje. Een link maak je zo: de homepage van Managementpraat, met de tekst tussen blokhaken en het adres tussen haakjes erachter. Links kleuren rood en zijn onderstreept.

Lijsten

Een opsomming zonder volgorde, met een streepje per regel:

• kritisch denken
• beter beslissen
• helder opschrijven

Een genummerde lijst, met cijfers:

1. eerst begrijpen
2. dan beoordelen
3. pas daarna besluiten

Citaat

Een citaat zet je achter een >:

Zo ziet een citaat eruit. De rode lijn ervoor en de cursieve letter komen vanzelf.

Code

Een woord in code-letters zet je tussen accent-tekens. Een heel blok maak je met drie accent-tekens op de regel erboven en eronder:

Dit is een codeblok.
Het houdt regeleinden precies zoals je ze typt.

Tabel

Een tabel bouw je met verticale strepen; de tweede regel met streepjes scheidt de koppen van de rijen:

Onderdeel	Hoe je het maakt
Kop	## tot en met ####
Vet	twee sterretjes
Citaat	> aan het regelbegin

Afbeelding

Een afbeelding zet je in de map public/images/ en haal je op met een uitroepteken, blokhaken en het pad. De tekst tussen de blokhaken beschrijft wat er te zien is:

Scheidingslijn

Drie streepjes op een eigen regel geven een dunne scheidingslijn, voor een adempauze zonder nieuw kopje:

---

Publiceren

Bestand opslaan, committen en pushen naar GitHub. De site bouwt en publiceert zichzelf daarna automatisch.