Kas yra Markdown derybos ir kodėl svetainė turėtų jas palaikyti?
Markdown derybos yra būdas tuo pačiu adresu atiduoti dvi turinio versijas: naršyklei HTML, o agentui, atsiuntusiam antraštę Accept: text/markdown, gryną tekstą be maketo. Agentas gauna tik tai, ką realiai skaito, ir sunaudoja kelis kartus mažiau žetonų. Naujų adresų tam kurti nereikia.
Kai kalbos modelio agentas atsidaro tavo puslapį, jis gauna tą patį HTML, kaip
ir naršyklė: navigaciją, poraštę, sutikimų juostą, <script> blokus, CSS klases.
Pirmas jo darbas — visa tai išmesti ir pasilikti tekstą.
Tą darbą galima padaryti už jį. Ir tai pigiau abiem pusėms.
Kaip tai veikia
Agentas siunčia įprastą užklausą, tik su antrašte:
Accept: text/markdown
Serveris tuo pačiu adresu grąžina ne HTML, o markdown'ą — antraštes, pastraipas, sąrašus, nuorodas. Naršyklė tos antraštės nesiunčia ir toliau gauna HTML.
Vienas adresas, du pavidalai. Tai standartinis HTTP mechanizmas, vadinamas turinio derybomis, ir jam nereikia nei naujo protokolo, nei bibliotekos.
Kiek tai sutaupo
Skaičius priklauso nuo maketo, bet eilė visada ta pati. Tipiniame turinio puslapyje HTML yra 5–10 kartų didesnis už tekstą, kurį jis neša: didžiąją dalį sudaro klasės, atributai, inline stiliai ir skriptai.
Agentui tai tiesiogiai reiškia žetonus. Puslapis, kuris HTML pavidalu kainuoja 8000 žetonų, markdown pavidalu kainuoja apie 1200 — ir tai tas pats turinys, tik be to, ko modelis vis tiek nenaudoja.
Svarbiau už kainą yra tai, kad į konteksto langą telpa daugiau tavo puslapio. Ilgas straipsnis, kuris anksčiau būdavo nukirptas per pusę, dabar patenka visas.
Trys dalykai, kurie čia yra sąlyga
Vary: Accept siunčiamas abiem atsakymams. Be jos tarpinis kešas gali
atiduoti markdown'ą naršyklei arba HTML agentui. Klaida nematoma tol, kol kas
nors nepasiskundžia, kad puslapis „rodo kodą".
Jokių .md adresų. /kainos.md būtų dar viena to paties puslapio kopija
paieškos indekse — tiksliai ta pati problema, kaip su ?lang= parametrais.
Derybos vyksta tuo pačiu adresu arba nevyksta.
Tik vieši indeksuojami puslapiai. Puslapis už prisijungimo ar su noindex
markdown pavidalu būtų tas pats turinys antru pavidalu, tik be jokios apsaugos.
Ką dar deklaruoti
Kartu su atsakymu siunčiamos Link antraštės (RFC 8288). Dvi iš jų turi
prasmę:
Link: </llms.txt>; rel="describedby"
Link: <https://pavyzdys.lt/kainos>; rel="alternate"; type="text/markdown"
Pirmoji rodo į llms.txt — svetainės žemėlapį agentui. Antroji pasako, kad šitas adresas turi markdown pavidalą, ir tai vienintelis būdas apie derybas sužinoti neatspėjus.
Ar tai duoda SEO?
Ne, ir teigti kitaip būtų rinkodara. Google reitingui tai neturi jokios įtakos, o markdown versijos jis neindeksuoja.
Nauda yra kita ir siauresnė. Agentas, kuris tavo puslapį perskaito pilnai ir pigiai, tavo turinį panaudoja dažniau nei tas, kuriam iš puslapio liko pusė. Tai GEO klausimas, ne SEO — ir jis apie tai, ar tavo tekstas apskritai patenka į atsakymą, o ne apie tai, kelintas esi sąraše.
Riba čia sąžininga: tai maža pagerinimo priemonė svetainėms, kurios visą kitą jau padarė. Jei puslapiai neindeksuojami arba neturi struktūros, markdown nepadės — pradėti reikia nuo to, kaip AI renkasi, ką cituoti.
Kaip patikrinti
Vienos komandos užtenka:
curl -H "Accept: text/markdown" -i https://pavyzdys.lt/
Jei atsakyme matyti Content-Type: text/markdown ir Vary: Accept, derybos
veikia. Jei matyti HTML — jų nėra.
Nemokamas skenas tikrina platesnę agentų pusę: llms.txt, robots.txt
turinio signalus, Link antraštes ir tai, ar puslapiai apskritai pasiekiami
botui, kuris nevykdo JavaScript.
Susiję straipsniai
Ta pati tema iš kitos pusės — kiekvienas atsako į savo klausimą:
Kaip šitas dalykas patenka į balą, aprašyta ties ką tikriname.
Šaltiniai
Tai, kuo remiasi šis tekstas — pirminiai šaltiniai, ne perpasakojimai:
Dažni klausimai
Ar reikia rašyti antrą, markdown versiją ranka?
Ne, ir to daryti nereikėtų. Markdown generuojamas iš to paties šaltinio; ranka rašyta antra versija po mėnesio pradeda meluoti.
Ar Google už tai nebaus kaip už cloaking'ą?
Ne, kol turinys tas pats. Cloaking yra **skirtingas** turinys skirtingiems lankytojams. Čia tas pats tekstas kitu formatu — tas pats principas, kaip atiduoti puslapį suspaustą arba nesuspaustą.
Kurie agentai tai jau naudoja?
Palaikymas dar nevienodas ir plečiasi. Todėl `Link` antraštė svarbi: ji leidžia apie markdown pavidalą sužinoti tam, kuris jo dar neprašo.
Ar verta tai daryti mažai svetainei?
Tik po visko kito. Tai paskutinis procentas, o ne pirmas žingsnis.
Pasitikrink
Nemokamas skenas parodo, ką iš to, kas aprašyta, tavo svetainė jau daro, o ko — ne.