İnsanlar ve Makineler Farklı Okur: Cascading Markdown Sheets ile Çözüm

Sorun: İnsanlar ve Makineler Farklı Okur

İnsan kullanıcılar için web siteleri görsel olarak düzenlenir: menüler, sidebarlar, footerlar, çerez bildirimleri. Ancak yapay zeka ajanları (LLM'ler) bu karmaşık HTML yapısını aynı şekilde işleyemez. Sonuç olarak, AI modelleri gerçekte var olmayan yapılar uydurur (halüsinasyon). Bu soruna medya sorguları gibi bir yaklaşım getirilmelidir: farklı okuyucular için farklı sunum.

Cascading Markdown Sheets (CMS) Nedir?

CSS'den ilham alan bu konsept, AI ajanlarına aynı içeriği farklı bir formatta sunar. Medya sorguları ekran boyutuna göre düzenleme yaparken, CMS ise kimin sorduğuna göre içeriği yapılandırır. Yazar, bu fikri "Cascading Markdown Sheets" olarak adlandırıyor.

MagpieCSS Framework'ü

MagpieCSS, daha büyük bir proje olan MagpieStash'tan çıkarılmış bir CSS ve JavaScript tasarım sistemidir. Ana MagpieCSS nesnesine eklenen "cms" ad alanı, AI ajanlarını tanıyarak onlara temiz Markdown sunar.

toMarkdown() Metodu

İlgili ajan kendisini AI olarak tanımlarsa, framework DOM alt ağacını temiz Markdown'a dönüştürür. Bu dönüşüm sırasında gereksiz layıklar (nav, copy butonları, tema kontrolleri) atılır, ancak başlıklar, tablolar, kod blokları, listeler gibi semantik yapılar korunur. İşte uygulama parçası:

// MagpieCSS.cms — Cascading Markdown Sheets
// Recursively compiles a DOM subtree into clean, token-efficient Markdown.
// Strips layout chrome, nav, copy buttons, and theme controls.
// Preserves semantic structure: headings, tables, code blocks, lists, and trees.
toMarkdown : function ( element , indentLevel = 0 ) {
    const cmsRef = this ;
    const recurse = ( el , level ) => {
        if ( ! el ) return '' ;
        // Strip layout chrome that agents do not need
        if ( el . classList && ( el . classList . contains ( ' hide-print ' ) || el . classList . con…
    };

Sonuç

AI ajanlarının web sayfalarını daha iyi anlaması için, onlara özel temiz bir sunum sağlamak şarttır. Cascading Markdown Sheets, tıpkı medya sorgularının farklı ekranlara uyum sağlaması gibi, farklı okuyucu türlerine uyum sağlar. MagpieCSS bu çözümü uygulayan bir framework olarak öne çıkmaktadır.