Gedurende 22 jaar was Markdown een documentatieformaat. Je schreef README’s, blogberichten en notities. Het legde dingen uit aan mensen.

Toen veranderde er iets. In 2024 begonnen AI-codeerassistenten .cursorrules en copilot-instructions.md te lezen. In 2025 ontstond AGENTS.md als universele standaard. Begin 2026 bracht Andrej Karpathy autoresearch uit, waarbij de gehele menselijke bijdrage een Markdown-bestand is genaamd program.md.

De evolutie is duidelijk:

Tijdperk	Bestand	Doelgroep	Doel
2004-2023	`README.md`	Mensen	Documentatie
2024	`.cursorrules`	AI-codeerhulpmiddelen	Codeerstijlregels
2025	`AGENTS.md`	AI-coderingagents	Projectinstructies
2026	`program.md`	Autonome agents	Onderzoeksprogramma’s

Markdown is niet langer alleen documentatie. Het is een programmeertaal voor AI.

De drie generaties

Generatie 1: Documentatie (README.md)

De oorspronkelijke gebruikscase van Markdown. Je schrijft een README om mensen te helpen je project te begrijpen. Het is passief — het ligt er totdat een mens het leest. Geen machine voert er actie op uit.

Generatie 2: Configuratie (AGENTS.md, CLAUDE.md)

AI-codeerassistenten hebben projectcontext nodig. AGENTS.md vertelt hen je bouwcommando’s, coderingconventies en architectuurbeslissingen. CLAUDE.md past het gedrag van Claude Code aan. Deze bestanden zijn actief — een AI leest ze en past zijn gedrag dienovereenkomstig aan.

Maar de mens schrijft nog steeds de code. Het Markdown-bestand helpt de AI alleen beter te assisteren.

Generatie 3: Programmeren (program.md)

Met autoresearch schrijft de mens helemaal geen code. De gehele bijdrage is program.md — een Markdown-bestand dat onderzoeksdoelen, beperkingen en strategie definieert. De AI-agent leest het en schrijft vervolgens autonoom code, voert die uit en itereert daarop gedurende uren of dagen.

Dit is Markdown als programmeertaal. De output is geen opgemaakt tekst — het zijn draaiende code, experimentresultaten en wetenschappelijke ontdekkingen.

Waarom Markdown?

Waarom zijn alle AI-systemen samengekomen op Markdown in plaats van, zeg, YAML, JSON of een aangepaste DSL?

Het zit in de trainingsdata. LLM’s hebben tijdens training miljarden Markdown-bestanden gezien. Ze begrijpen de conventies diepgaand — koppen duiden hiërarchie aan, opsommingstekens duiden lijsten aan, codeblokken duiden uitvoerbare inhoud aan.

Het is flexibel. Markdown legt geen rigide schema op. Je kunt vrije instructies, gestructureerde tabellen, codevoorbeelden en natuurlijke taal allemaal in hetzelfde bestand schrijven. Deze flexibiliteit past bij de manier waarop mensen nadenken over het aansturen van AI-agents.

Het is controleerbaar. Je kunt een program.md lezen en precies begrijpen wat de agent te horen krijgt. Probeer dat eens met een YAML-configuratie van 500 regels.

Het is versiebeheerbaar. Elke wijziging in de instructies van je agent is een git commit. Je kunt wijzigingen in het agentgedrag vergelijken, beoordelen en terugdraaien net als codechanges.

Wat dit voor jou betekent

Als Markdown een programmeertaal wordt, wordt iedereen die Markdown schrijft in zekere zin een programmeur. De vaardigheid is niet de syntax — het is helderheid van gedachte en precisie van instructie.

Dit is nu belangrijk:

Leer precieze Markdown-instructies schrijven. Hoe beter je AGENTS.md of program.md, hoe beter je AI-agent presteert. Dit is een nieuwe vaardigheid die technische kennis combineert met helder schrijven.

Bouw een referentiebibliotheek in Markdown. Wanneer je instructies schrijft voor AI-agents, heb je referentiemateriaal nodig: documentatie, voorbeelden, papers, beste praktijken. Dit materiaal in schoon Markdown-formaat hebben maakt het onmiddellijk bruikbaar.

Begrijp het Markdown-voor-AI-ecosysteem. Ken het verschil tussen AGENTS.md, CLAUDE.md, llms.txt en program.md. Elk dient een ander doel in de groeiende Markdown-voor-AI-stack.

Kennis vastleggen voor agentinstructies

Het schrijven van goede AI-agentinstructies vereist kennis. Je moet het domein, de hulpmiddelen, de beperkingen en de doelen begrijpen. Veel van deze kennis leeft op het web — in documentatiepagina’s, blogberichten, onderzoeksdocumenten en tutorials.

Save converteert al deze webbronnen met één klik naar schone Markdown. Wanneer je een program.md of AGENTS.md opstelt, betekent het hebben van je referentiemateriaal al in Markdown dat je er onmiddellijk uit kunt excerperen, naar kunt verwijzen en op kunt voortbouwen.

De onderzoekers die de beste program.md-bestanden schrijven beginnen niet vanaf nul. Ze bouwen voort op kennis die ze in Markdown-formaat hebben vastgelegd en georganiseerd.

Save converteert elke webpagina naar schone Markdown — perfect voor het opbouwen van de referentiebibliotheek die je nodig hebt om effectieve AI-agentinstructies te schrijven. Probeer Save gratis.