acceptmarkdown.com, AI agentlerine Accept headerları üzerinden Markdown sunulması için gerekçeleri sıralıyor

Site ne öneriyor

Hacker News'in ana sayfasına çıkan acceptmarkdown.com adlı proje basit bir fikri savunuyor: AI agentlerine sayfanın Markdown sürümünü iletmek için sıradan HTTP içerik müzakeresini kullanın. Bir istemci bir URL'yi Accept: text/markdown ile istediğinde, origin tam HTML belgesi yerine makaleyi Markdown olarak döndürüyor ve agent istemciler içeriği doğrudan okuyabiliyor; gezinme, scriptler ve yerleşim işaretlemesinin etrafından dolanmak zorunda kalmıyor.

Siteye göre yayıncıların içeriği zaten elinde; Markdown varyantı bunu yalnızca görünür kılıyor ve hem insanlara hem makinelere hizmet veren tek bir kanonik URL korunuyor.

Vaat: tokenlar, retrieval kalitesi, hız

acceptmarkdown.com üç gerekçe sıralıyor. İlki bağlam verimliliği: Markdown temsili gezinme, stiller, scriptler ve yapısal sarmalayıcıları ayıkladığı için agentin sınırlı context window'u işaretlemeye değil yazının kendisine harcanıyor. İkincisi retrieval kalitesi: payloadda reklam, öneri kenar çubukları veya overlay diyaloglar bulunmadığından RAG pipeline'ının embed ettiği metin daha temiz oluyor ve sinyal-gürültü oranı yükseliyor. Üçüncüsü hız: çok daha küçük bir yanıt, model üretmeye başlamadan önce indirilip işlenecek şeyi azaltıyor ve ilk output tokenı için bekleme süresini kısaltıyor.

Kontrol ve dağıtım için araçlar

Sitede "URL'niz AI'ya ne kadar hazır?" başlıklı bir denetleyici bulunuyor. Kullanıcı bir URL giriyor, servis isteği kendi edge'inden gönderiyor ve origin'in nasıl yanıt verdiğini raporluyor. Test dört kritere bakıyor: Accept: text/markdown için Markdown sunulup sunulmadığı, yanıtın Vary: Accept belirleyip belirlemediği, desteklenmeyen medya tiplerinin HTTP 406 ile reddedilip edilmediği ve q-value tercihlerine saygı gösterilip gösterilmediği.

Uygulama için, iki temsil üreten tek sunuculuk minimal bir kurulumu anlatan bir hızlı başlangıç bölümü ve doğruluk ayrıntıları üzerine rehberler var: Vary, q-value'lar, 406 yanıtları, caching ve Cloudflare üzerinde sıfır yapılandırmalık bir kısayol. Bir recipes bölümü, Nginx, Apache, Caddy, Cloudflare Workers, Next.js, Astro, SvelteKit, Nuxt/Nitro, Express, Go, Django, Rails, Laravel, WordPress ve Discourse dahil olmak üzere ana akım web stack'inin büyük kısmı için kopyala-yapıştır yapılandırmaları sunuyor.

İstemcilere de bağlı

Bu kalıbın işe yaraması, agentlerin gerçekten Markdown istemesine bağlı. Bu amaçla site, hangi AI agentlerin browse veya fetch araçları yaptığı isteklere Accept: text/markdown'u dahil ettiğini izleyen bir AI agent destek matrisi tutuyor; açık değişkenin sunucu yapılandırması değil istemci benimsenmesi olduğunun itirafı bu. Bir referans bölümü yaklaşımı mevcut standartlara dayandırıyor: HTTP semantiği için RFC 9110'a ve text/markdown medya tipini kaydeden RFC 7763'e, ilgili diğer spesifikasyonlarla birlikte atıfta bulunuyor.

Neden önemli

İçerik müzakeresi HTTP'nin en eski özelliklerinden biri ve bu öneri yeni bir format, endpoint ya da sidecar dosya icat etmek yerine onu yeniden kullanıyor. Bu, benimseme maliyetini düşük tutuyor: aynı URL hem tarayıcılara hem agentlere hizmet veriyor ve mevcut cache'ler, CDN'ler ve frameworkler bunu destekleyecek şekilde yapılandırılabilir. Doğruluk gereksinimleri gerçek: Vary: Accept atlanması cache'lerin yanlış istemciye yanlış temsili sunmasına yol açabilir ve katı 406 işlemi, alışılmadık Accept headerları gönderen istemcileri bozabilir; sitedeki rehberlerin tam da bunda karşılığı var. Otomatik trafik ziyaretlerin anlamlı bir payı haline gelirse, temiz müzakere eden siteler daha ucuz agent sorguları ve kendi içerikleri hakkında daha doğru yanıtlar elde eder; hiç olmazsa değişiklik pek bir şeye mal olmuyor. Kontrol listesi, doğrulayıcı ve kocaman bir sunucu reçeteleri yığınının birleşimi olarak acceptmarkdown.com, kalıbı kendi altyapısında denemek isteyenler için eşiği düşürüyor.