Sessie 16: Coach-notities

Doel van deze sessie

Aan het einde van deze sessie kan een ninja:

Een .md-bestand aanmaken en openen in een editor.
Koppen, alinea’s, vet, cursief en doorstreepte tekst schrijven.
Genummerde en ongenummerde lijsten maken (inclusief geneste lijsten).
Externe links en interne links leggen.
Een tabel met kolommen en uitlijning opbouwen.
Codeblokken met syntax highlighting gebruiken.
Een volledige README.md schrijven die koppen, lijsten, links en code combineert.

Voorbereiding (30 min vóór de sessie)

Editor met Markdown-preview klaar. VS Code is ideaal (ingebouwde preview met Ctrl+Shift+V). Obsidian werkt ook. Als niets beschikbaar is: gebruik een online editor zoals dillinger.io of stackedit.io. Zorg dat de preview zichtbaar is op de projector.
Demo-bestand klaar. Maak een demo.md met voorbeelden van elke Markdown-feature (kop, lijst, link, tabel, codeblok). Gebruik dit om live te tonen hoe Markdown eruitziet als platte tekst én als preview.
Thonny als fallback. Als ninjas niets anders hebben: Thonny opent .md-bestanden als platte tekst. Ze kunnen de syntax leren zonder preview; de preview is fijn maar niet essentieel.

Tijdsindeling (3 uur)

Tijd	Activiteit
0:00 tot 0:10	Wat is Markdown? Waar kom je het tegen? (GitHub, notities, deze site)
0:10 tot 0:30	Projector: demo (elke feature live tonen en preview laten zien)
0:30 tot 1:00	Zelfstandig: koppen, opmaak, lijsten
1:00 tot 1:15	Pauze
1:15 tot 1:45	Projector: links, afbeeldingen, tabellen, codeblokken
1:45 tot 2:30	Zelfstandig: volledige README schrijven
2:30 tot 2:45	Showcase: toon je README (platte tekst + preview)
2:45 tot 3:00	Afsluiting, take-home

Veelgestelde vragen

“Moet ik Markdown uit mijn hoofd leren?” Nee. De meeste editors hebben knoppen voor opmaak (zoals Word). Maar de syntax kennen is handig: je typt sneller, en op platforms zoals GitHub heb je alleen de platte tekst.

“Wat is het verschil tussen Markdown en HTML?” HTML is voor browsers: ingewikkeld, met tags als <h1>, <p>, <a href="">. Markdown is voor mensen: simpel, leesbaar als tekst. Onder water wordt Markdown omgezet naar HTML. Maar je hoeft nooit HTML te schrijven.

“Kan ik Markdown gebruiken in Word of Google Docs?” Niet direct. Word gebruikt zijn eigen opmaak. Maar je kunt Markdown schrijven in een .md-bestand en het later converteren naar PDF, HTML, of Word. Tools zoals Pandoc doen dat.

“Waarom heet het Markdown?” Het is een woordspeling op “markup” (opmaaktaal). Markdown = “markup” maar dan “down”: simpeler, minder gedoe.

Hints voor Stretch en Expert

Stretch: geneste lijsten: Twee spaties inspringen is genoeg voor een sub-lijst. Vier spaties werkt ook. Consistent zijn is belangrijker dan hoeveel spaties.

Expert: Markdown in Git: Combineer deze sessie met sessie 11: maak een README.md, zet hem in een Git-repository, en commit hem. Je eerste Markdown-document in versiebeheer.

Praktische valkuilen

Vergeten lege regel voor een lijst. Een lijst moet voorafgegaan worden door een lege regel, anders plakt Markdown hem aan de vorige alinea. Dit is de grootste bron van “waarom werkt mijn Markdown niet?”
Spaties in opmaak. ** vet ** werkt niet: geen spaties tussen de sterretjes en de tekst. **vet** wel. Dit is wennen voor wie gewend is aan Word.
Tabellen uitlijnen. De : in de scheidingsregel (:---, :---:, ---:) bepaalt links/midden/rechts uitlijning. Een veelgemaakte fout is deze : vergeten en dan klagen dat de tabel niet uitlijnt.