Von README.md zu PROGRAM.md: Markdown ist jetzt eine Programmiersprache

·

22 Jahre lang war Markdown ein Dokumentationsformat. Man schrieb READMEs, Blogbeiträge und Notizen. Es erklärte Dinge an Menschen.

Dann änderte sich etwas. 2024 begannen KI-Coding-Assistenten, .cursorrules und copilot-instructions.md zu lesen. 2025 etablierte sich AGENTS.md als universeller Standard. Anfang 2026 veröffentlichte Andrej Karpathy Autoresearch, bei dem der gesamte menschliche Beitrag eine Markdown-Datei namens program.md ist.

Die Entwicklung ist klar:

ÄraDateiZielgruppeZweck
2004-2023README.mdMenschenDokumentation
2024.cursorrulesKI-Coding-ToolsCode-Stil-Regeln
2025AGENTS.mdKI-Coding-AgentenProjektanweisungen
2026program.mdAutonome AgentenForschungsprogramme

Markdown ist nicht mehr nur Dokumentation. Es ist eine Programmiersprache für KI.

Die drei Generationen

Generation 1: Dokumentation (README.md)

Der ursprüngliche Markdown-Anwendungsfall. Man schreibt eine README, um Menschen das eigene Projekt zu erklären. Sie ist passiv — sie wartet, bis ein Mensch sie liest. Keine Maschine handelt auf ihrer Basis.

Generation 2: Konfiguration (AGENTS.md, CLAUDE.md)

KI-Coding-Assistenten brauchen Projektkontext. AGENTS.md teilt ihnen Build-Befehle, Coding-Konventionen und Architekturentscheidungen mit. CLAUDE.md passt das Verhalten von Claude Code an. Diese Dateien sind aktiv — eine KI liest sie und ändert ihr Verhalten entsprechend.

Aber der Mensch schreibt noch den Code. Die Markdown-Datei hilft der KI nur, besser zu assistieren.

Generation 3: Programmierung (program.md)

Mit Autoresearch schreibt der Mensch überhaupt keinen Code. Der gesamte Beitrag ist program.md — eine Markdown-Datei, die Forschungsziele, Einschränkungen und Strategie definiert. Der KI-Agent liest sie und schreibt, führt aus und iteriert dann stunden- oder tagelang autonom Code.

Das ist Markdown als Programmiersprache. Das Ergebnis ist kein formatierter Text — es sind laufender Code, experimentelle Ergebnisse und wissenschaftliche Entdeckungen.

Warum Markdown?

Warum haben alle KI-Systeme auf Markdown konvergiert statt auf YAML, JSON oder eine benutzerdefinierte DSL?

Es ist in den Trainingsdaten. LLMs haben während des Trainings Milliarden von Markdown-Dateien gesehen. Sie verstehen seine Konventionen tiefgründig — Überschriften zeigen Hierarchie an, Aufzählungspunkte zeigen Listen an, Codeblöcke zeigen ausführbaren Inhalt an.

Es ist flexibel. Markdown zwingt kein starres Schema auf. Man kann Freitext-Anweisungen, strukturierte Tabellen, Codebeispiele und natürliche Sprache in derselben Datei schreiben. Diese Flexibilität passt dazu, wie Menschen über die Steuerung von KI-Agenten nachdenken.

Es ist überprüfbar. Man kann ein program.md lesen und genau verstehen, was dem Agenten gesagt wird zu tun. Versuchen Sie das mit einer 500-zeiligen YAML-Konfiguration.

Es ist versionierbar. Jede Änderung an den Agentenanweisungen ist ein Git-Commit. Man kann Agentenverhaltensänderungen genauso wie Code-Änderungen vergleichen, prüfen und rückgängig machen.

Was das für Sie bedeutet

Wenn Markdown zu einer Programmiersprache wird, dann wird jeder, der Markdown schreibt, irgendwie zum Programmierer. Die Fähigkeit liegt nicht in der Syntax — sie liegt in der Klarheit des Denkens und der Präzision der Anweisung.

Was jetzt wichtig ist:

Präzise Markdown-Anweisungen schreiben lernen. Je besser Ihr AGENTS.md oder program.md, desto besser performt Ihr KI-Agent. Das ist eine neue Fähigkeit, die technisches Wissen mit klarem Schreiben verbindet.

Eine Referenzbibliothek in Markdown aufbauen. Wenn man Anweisungen für KI-Agenten schreibt, braucht man Referenzmaterial: Dokumentation, Beispiele, Artikel, Best Practices. Dieses Material in sauberem Markdown-Format zu haben, macht es sofort nutzbar.

Das KI-Markdown-Ökosystem verstehen. Den Unterschied zwischen AGENTS.md, CLAUDE.md, llms.txt und program.md kennen. Jedes dient einem anderen Zweck im wachsenden Markdown-for-AI-Stack.

Wissen für Agentenanweisungen erfassen

Gute KI-Agentenanweisungen zu schreiben erfordert Wissen. Man muss die Domäne, die Tools, die Einschränkungen und die Ziele verstehen. Viel dieses Wissens lebt im Web — in Dokumentationsseiten, Blogbeiträgen, Forschungsartikeln und Tutorials.

Save konvertiert jede dieser Web-Quellen mit einem Klick in sauberes Markdown. Wenn man ein program.md oder AGENTS.md erstellt, bedeutet das Referenzmaterial bereits in Markdown zu haben, dass man sofort Auszüge erstellen, referenzieren und darauf aufbauen kann.

Die Forscher, die die besten program.md-Dateien schreiben, fangen nicht bei Null an. Sie bauen auf Wissen auf, das sie im Markdown-Format erfasst und organisiert haben.


Save konvertiert jede Webseite in sauberes Markdown — perfekt, um die Referenzbibliothek aufzubauen, die man braucht, um effektive KI-Agentenanweisungen zu schreiben. Save kostenlos testen

## Continue reading

Jean-Sébastien Wallez

Written by

Jean-Sébastien Wallez

I've been making internet products for 10+ years. Built Save on weekends because I wanted my own reading library in clean markdown for Claude and Obsidian. Write here about web clipping, AI workflows, and the small things that make a personal knowledge base actually useful.