Walang Markdown na bersyon para sa mga AI agent

Maikling sagot

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.

agent.no_markdown · Priyoridad: P3

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

  1. Pumili ng isang paraan ng pagbibigay ng Markdown: sagutin ang Accept: text/markdown sa mismong URL ng pahina, o mag-publish ng kopya gaya ng /guide/index.md.
  2. 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/markdown ang Accept header.
  3. Ipadala ang Content-Type: text/markdown; charset=utf-8 at, kapag pareho ang URL sa HTML page, Vary: Accept.
  4. 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.
  5. 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.

Suriin ang pahina ko →

Mga kaugnay na gabay

Lahat ng natuklasan at paano gumagana ang score