Hakuna toleo la Markdown kwa mawakala wa AI

Jibu fupi

Ukurasa ulipoombwa kwa Accept: text/markdown, seva ilituma HTML, na ukurasa hauna kiungo cha nakala ya Markdown. Basi mawakala wa AI husoma HTML yote, pamoja na menyu, sehemu ya chini na script. Kutoa toleo la Markdown si lazima: ni desturi changa, kwa hivyo hii ni P3.

agent.no_markdown · Kipaumbele: P3

Maana yake

Ulipoombwa kwa Accept: text/markdown, ukurasa ulijibu kwa HTML, na hauna kiungo cha nakala ya Markdown (<link rel="alternate" type="text/markdown">). Basi mawakala husoma HTML yote, pamoja na menyu na script. Si lazima: Markdown kwa mawakala ni desturi changa, si kiwango rasmi.

Kwa nini ni muhimu kwa utafutaji wa AI

Mawakala wanaovinjari kwa niaba ya mtumiaji (na zana zinazopakia kurasa kwenye muktadha wa modeli) hufanya kazi na maandishi, si mpangilio. Toleo safi la Markdown la ukurasa ni dogo mara kadhaa kuliko HTML yake na huhifadhi vichwa, orodha na viungo vilivyo muhimu. Baadhi ya CDN na framework tayari hujibu Accept: text/markdown kwa toleo kama hilo, na llmstxt.org inapendekeza nakala ya .md kando ya kila ukurasa.

Hakuna kinachoharibika bila hilo: crawler bado husoma HTML. Ni uboreshaji wa bei nafuu baada ya dosari za ufikiaji, robots.txt na maudhui kurekebishwa.

Jinsi ya kurekebisha

  1. Chagua njia moja ya kutoa Markdown: jibu Accept: text/markdown kwenye URL ya ukurasa wenyewe, au chapisha nakala kama /guide/index.md.
  2. Kwenye CDN, washa ubadilishaji wake wa Markdown kwa mawakala kama upo. Kwenye framework, ongeza middleware inayorudisha toleo la Markdown pale kichwa cha Accept kinapoomba text/markdown.
  3. Tuma Content-Type: text/markdown; charset=utf-8 na, pale URL ni ileile ya ukurasa wa HTML, Vary: Accept.
  4. Unganisha nakala kutoka head ya HTML kwa <link rel="alternate" type="text/markdown">, ili mawakala wasiojadiliana maudhui waweze kuipata pia.
  5. Endesha "Kagua tena" kwenye ripoti ya ukurasa kuthibitisha matokeo.

Mfano

<!-- 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

Jinsi ya kuthibitisha rekebisho

Baada ya badiliko, bonyeza "Kagua tena" kwenye ripoti: inaorodhesha kilichorekebishwa na jinsi alama ilivyobadilika.

Kagua ukurasa wangu →

Miongozo inayohusiana

Dosari zote na jinsi alama inavyofanya kazi