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
• Antwoord B
• Antwoord C Toelichting: Antwoord B is juist omdat ...

Multi antwoord

Vraag: Welke opties zijn juist?

• Optie 1
• 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.