Lagani tekstualni format koji AI alati koriste za uputstva i konfiguraciju jer ga razumeju i ljudi i modeli.
Markdown je jednostavan format za pisanje teksta sa laganim formatiranjem (naslovi, liste, linkovi) koji ostaje čitljiv i kao običan tekst. AI alati ga masovno koriste za uputstva, konfiguraciju i znanje jer je istovremeno čitljiv ljudima i lako razumljiv modelima, a troši malo tokena.
Kako radi u praksi
Formatiranje se piše znakovima koji se vide u samom tekstu: rešetka označava naslov, crtica stavku liste, zvezdice isticanje. Nema nevidljivih oznaka kao u dokumentima tekst procesora, pa se isti fajl čita u editoru, u terminalu i u pregledaču, a razlike se lepo vide u sistemu za verzionisanje koda.
U radu sa AI alatima to izgleda ovako: u korenu projekta stoji CLAUDE.md sa pravilima kuće, kako se pokreću testovi, kako se imenuju grane, šta se nikada ne dira. Asistent tu datoteku pročita na početku i ponaša se u skladu sa njom, umesto da mu se ista pravila diktiraju u svakom razgovoru. Po istom principu rade i Skills datoteke i llms.txt, kojim sajt jezičkim modelima nudi uredan pregled svog sadržaja.
Zašto je bitno i gde se sreće
Struktura u Markdownu modelu daje jeftin orijentir: naslovi kažu gde počinje koja tema, liste razdvajaju korake, blokovi koda jasno odvajaju komande od objašnjenja. Model zato lakše pronađe traženi deo u dugačkom uputstvu nego u tekstu bez ikakve strukture.
Za tim je važno i to što uputstvo za model postaje deo repozitorijuma. Menja se kroz uobičajeni pregled izmena, ima istoriju i vlasnika, i isto radi za svakog člana tima. Zbog toga se u ozbiljnim projektima pravila za agente drže uz kod, a ne u privatnim beleškama pojedinca.
Isti razlog stoji iza toga što modeli i odgovaraju u Markdownu. Kada asistent vrati tekst sa naslovima i listama, taj tekst se bez prepravki uklapa u dokumentaciju, opis zadatka ili poruku, pa format postaje zajednički jezik između čoveka, modela i alata koji ih povezuju.
Česta zabluda
Prva zabluda je da modeli razumeju samo Markdown. Razumeju i običan tekst, HTML, JSON i tabele, ali Markdown je najbolji kompromis: dovoljno strukture za model, dovoljno jednostavnosti za čoveka, bez suvišnih znakova koji troše kontekst.
Druga zabluda je da je dovoljno napisati veliku datoteku sa uputstvima pa da prompt više nije potreban. Predugačko uputstvo se u praksi razvodni, pa se najbolje pokazuju kratki i konkretni fajlovi koji se dopunjuju kada se pojavi nova potreba. Treću grešku prave timovi koji u ovakve datoteke stave lozinke i ključeve, zaboravljajući da ih model pročita u celini i da završe u istoriji repozitorijuma.