markdown_to_skillstown/ai-markdown-instructie.md

# Instructie Voor AI-Model: OnlineAcademy Markdown

Gebruik onderstaande instructie letterlijk of bijna letterlijk als prompt voor een willekeurig AI-model dat content moet opleveren in het Markdown-format voor de OnlineAcademy-runner.

## Aanbevolen prompt

Je schrijft content in een strikt Markdown-template voor import naar een OnlineAcademy-automatisering. Volg onderstaande regels exact.

Doel:
- Lever alleen geldige Markdown op.
- Gebruik exact de koppen en veldnamen uit dit format.
- Voeg geen uitleg, geen inleiding, geen analyse en geen code fences toe.
- Geef dus alleen het uiteindelijke Markdown-document terug.

Algemene structuur:
- Optioneel bovenaan frontmatter:
  - `---`
  - `training: Naam van de training`
  - `---`
- Daarna één of meer modules:
  - `# Module: <titel>`
- Binnen elke module één of meer pagina's:
  - `## Pagina: <titel>`
- Binnen elke pagina één of meer blokken:
  - `### Tekst`
  - `### Kop`
  - `### Quote`
  - `### Tabel`
  - `### Afbeelding`
  - `### Meerkeuze`
  - `### Multi antwoord`
  - `### Open vraag`
  - `### Koppelvraag`

Gebruik alleen deze bloktypes. Verzin geen andere blokkoppen.

Veldnamen moeten exact zo worden geschreven:
- `**Titel:**`
- `**Tekst:**`
- `**Auteur:**`
- `**Top header:**`
- `**Left header:**`
- `**Bestand:**`
- `**Onderschrift:**`
- `**Alt:**`
- `**Vraag:**`
- `**Instructie:**`
- `**Toelichting:**`

Belangrijke inhoudsregels:
- Gebruik voor een meerkeuze- of multi-antwoordvraag antwoordregels in exact dit formaat:
  - `- [x] Correct antwoord`
  - `- [ ] Fout antwoord`
- Bij `Meerkeuze` moet exact 1 antwoord gemarkeerd zijn met `[x]`.
- Bij `Multi antwoord` moeten 1 of meer antwoorden gemarkeerd zijn met `[x]`.
- Bij `Multi antwoord` mogen maximaal 10 antwoorden worden gebruikt.
- Bij `Meerkeuze` en `Multi antwoord` moeten minimaal 2 antwoorden aanwezig zijn.
- Bij `Open vraag`, `Meerkeuze` en `Multi antwoord` mag de vraag maximaal 350 karakters lang zijn.
- Bij `Open vraag`, `Meerkeuze`, `Multi antwoord` en `Koppelvraag` mag de toelichting maximaal 999 karakters lang zijn.
- Bij `Tabel` mogen maximaal 5 kolommen en maximaal 20 rijen worden gebruikt.
- Bij `Tabel` moet `**Top header:**` of `Aan` of `Uit` zijn.
- Bij `Tabel` moet `**Left header:**` of `Aan` of `Uit` zijn.
- Bij `Afbeelding` moet `**Bestand:**` altijd aanwezig zijn met een relatief pad, bijvoorbeeld `afbeeldingen/diagram-1.png`.
- Gebruik alleen afbeeldingen die expliciet zijn opgegeven in de broninformatie.
- Laat optionele velden weg als er geen waarde is. Voeg dan geen lege placeholdertekst toe.

Opmaakregels:
- Gebruik geen codeblokken met backticks.
- Gebruik geen HTML.
- Gebruik geen tabellen buiten een `### Tabel` blok.
- Gebruik geen geneste module- of paginakoppen.
- Gebruik geen extra commentaarregels.
- Houd de volgorde logisch: module -> pagina -> blokken.
- Lever complete inhoud op, geen notities zoals `nog invullen`.

Syntax per blok:

Tekstblok:
`### Tekst`
Optioneel:
`**Titel:** <titel>`
Daaronder vrije Markdown-tekst.

Kopblok:
`### Kop`
Daaronder alleen de koptekst.

Quoteblok:
`### Quote`
`**Tekst:** <quote>`
Optioneel:
`**Auteur:** <naam>`

Tabelblok:
`### Tabel`
Optioneel:
`**Titel:** <titel>`
`**Top header:** Aan of Uit`
`**Left header:** Aan of Uit`
Daarna een normale Markdown-tabel.

Afbeeldingsblok:
`### Afbeelding`
`**Bestand:** afbeeldingen/bestandsnaam.png`
Optioneel:
`**Titel:** <titel>`
`**Onderschrift:** <onderschrift>`
`**Alt:** <alternatieve tekst>`

Meerkeuzeblok:
`### Meerkeuze`
`**Vraag:** <vraag>`
Daarna antwoordregels met `- [x]` of `- [ ]`
Afsluiten met:
`**Toelichting:** <uitleg>`

Multi-antwoordblok:
`### Multi antwoord`
`**Vraag:** <vraag>`
Daarna antwoordregels met `- [x]` of `- [ ]`
Afsluiten met:
`**Toelichting:** <uitleg>`

Open-vraagblok:
`### Open vraag`
`**Vraag:** <vraag>`
`**Toelichting:** <modelantwoord of uitleg>`

Koppelvraagblok:
`### Koppelvraag`
`**Instructie:** <opdrachttekst>`
Daarna koppelregels in exact dit formaat:
`- linker item = rechter item`
Afsluiten met:
`**Toelichting:** <uitleg>`

Gebruik dit voorbeeldformat:

---
training: Voorbeeldtraining
---

# Module: Moduletitel

## Pagina: Paginatitel

### Tekst
**Titel:** Optionele titel

Vrije tekst met **vet**, *cursief* en lijsten.

### Kop
Tussenkop

### Quote
**Tekst:** Dit is een quote.
**Auteur:** Auteur Naam

### Tabel
**Titel:** Overzicht
**Top header:** Aan
**Left header:** Uit
| Kolom A | Kolom B |
|---------|---------|
| Waarde 1 | Waarde 2 |
| Waarde 3 | Waarde 4 |

### Afbeelding
**Bestand:** afbeeldingen/voorbeeld.png
**Titel:** Voorbeeldafbeelding
**Onderschrift:** Korte toelichting
**Alt:** Beschrijving van de afbeelding

### Meerkeuze
**Vraag:** Welke optie is juist?
- [ ] Antwoord A
- [x] Antwoord B
- [ ] Antwoord C
**Toelichting:** Antwoord B is juist omdat ...

### Multi antwoord
**Vraag:** Welke opties zijn juist?
- [x] Optie 1
- [x] Optie 2
- [ ] Optie 3
**Toelichting:** Optie 1 en 2 zijn juist omdat ...

### Open vraag
**Vraag:** Leg in eigen woorden uit wat het verschil is.
**Toelichting:** Een goed antwoord benoemt ...

### Koppelvraag
**Instructie:** Koppel de juiste begrippen.
- Begrip 1 = Uitleg 1
- Begrip 2 = Uitleg 2
**Toelichting:** Dit zijn de correcte combinaties.

Extra eindcontrole voordat je antwoord geeft:
- Heeft elke pagina minimaal 1 blok?
- Heeft elke module minimaal 1 pagina?
- Zijn alle koppen exact gespeld?
- Heeft elke afbeelding een `Bestand`?
- Heeft elke meerkeuzevraag exact 1 correct antwoord?
- Heeft elke multi-antwoordvraag minimaal 1 correct antwoord en maximaal 10 antwoorden?
- Blijft elke tabel binnen 5 kolommen en 20 rijen?
- Geef alleen het definitieve Markdown-document terug.

## Praktisch gebruik

Voeg boven deze prompt eventueel nog brontekst toe zoals:
- doelgroep
- leerdoelen
- ruwe inhoud
- lijst met toegestane afbeeldingsbestanden
- gewenste hoofdstukindeling

Vraag het model daarna expliciet:

`Zet onderstaande inhoud om naar exact dit OnlineAcademy-Markdown-format. Geef alleen de definitieve Markdown terug.`