Walang Markdown na bersyon para sa mga AI agent
Nang hingin ang pahina gamit ang Accept: text/markdown, HTML ang ipinadala ng server, at walang naka-link na Markdown na kopya ang pahina. Kaya binabasa ng mga AI agent ang buong HTML, kasama ang mga menu, footer at script. Opsyonal ang pagbibigay ng Markdown na bersyon: bagong kumbensyon pa lang ito, kaya P3 ito.
Ano ang ibig sabihin nito
Nang hingin gamit ang Accept: text/markdown, HTML ang isinagot ng pahina, at wala itong naka-link na Markdown na kopya (<link rel="alternate" type="text/markdown">). Kaya binabasa ng mga agent ang buong HTML, kasama ang mga menu at script. Opsyonal: bagong kumbensyon pa lang ang Markdown para sa mga agent, hindi pa ito pamantayan.
Bakit ito mahalaga para sa AI search
Ang mga agent na nagba-browse para sa user (at ang mga tool na naglo-load ng mga pahina sa context ng model) ay gumagana sa teksto, hindi sa layout. Ilang beses na mas maliit ang malinis na Markdown na bersyon ng pahina kaysa sa HTML nito, at napapanatili nito ang mga heading, listahan at link na mahalaga. May ilang CDN at framework na sumasagot na sa Accept: text/markdown gamit ang ganitong bersyon, at iminumungkahi ng llmstxt.org ang isang .md na kopya sa tabi ng bawat pahina.
Walang nasisira kung wala ito: binabasa pa rin ng mga crawler ang HTML. Murang pagpapabuti ito kapag naayos na ang mga natuklasan sa access, robots.txt at content.
Paano ito ayusin
- Pumili ng isang paraan ng pagbibigay ng Markdown: sagutin ang
Accept: text/markdownsa mismong URL ng pahina, o mag-publish ng kopya gaya ng/guide/index.md. - Sa CDN, i-on ang Markdown conversion nito para sa mga agent kung mayroon. Sa framework, magdagdag ng middleware na nagbabalik ng Markdown na bersyon kapag humihingi ng
text/markdownangAcceptheader. - Ipadala ang
Content-Type: text/markdown; charset=utf-8at, kapag pareho ang URL sa HTML page,Vary: Accept. - I-link ang kopya mula sa head ng HTML gamit ang
<link rel="alternate" type="text/markdown">, para mahanap din ito ng mga agent na hindi nakikipag-negotiate ng content. - Patakbuhin ang "Suriin muli" sa ulat ng pahina para makumpirma ang resulta.
Halimbawa
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept Paano kumpirmahin ang ayos
Pagkatapos ng pagbabago, pindutin ang "Suriin muli" sa ulat: inililista nito kung ano ang naayos at paano nagbago ang score.