Tekoälyagenteille ei ole Markdown-versiota

Lyhyt vastaus

Kun sivua pyydettiin otsakkeella Accept: text/markdown, palvelin lähetti HTML:ää, eikä sivu linkitä Markdown-kopioon. Tekoälyagentit lukevat silloin koko HTML:n valikkoineen, alatunnisteineen ja skripteineen. Markdown-version tarjoaminen on valinnaista: se on nuori käytäntö, joten tämä on P3.

agent.no_markdown · Prioriteetti: P3

Mitä se tarkoittaa

Kun sivua pyydettiin otsakkeella Accept: text/markdown, se vastasi HTML:llä, eikä se linkitä Markdown-kopioon (<link rel="alternate" type="text/markdown">). Agentit lukevat silloin koko HTML:n valikkoineen ja skripteineen. Valinnainen: Markdown agenteille on nuori käytäntö, ei standardi.

Miksi tämä on tärkeää tekoälyhaussa

Käyttäjän puolesta selaavat agentit (ja työkalut, jotka lataavat sivuja mallin kontekstiin) käsittelevät tekstiä, eivät asettelua. Siisti Markdown-versio sivusta on monta kertaa HTML:ää pienempi ja säilyttää olennaiset otsikot, luettelot ja linkit. Jotkin CDN:t ja sovelluskehykset vastaavat jo otsakkeeseen Accept: text/markdown tällaisella versiolla, ja llmstxt.org ehdottaa .md-kopiota jokaisen sivun rinnalle.

Ilman sitä mikään ei mene rikki: indeksoijat lukevat edelleen HTML:n. Se on halpa parannus, kun pääsyä, robots.txt-tiedostoa ja sisältöä koskevat havainnot on korjattu.

Näin korjaat

  1. Valitse yksi tapa tarjota Markdownia: vastaa otsakkeeseen Accept: text/markdown sivun omassa URL-osoitteessa tai julkaise kopio, esimerkiksi /guide/index.md.
  2. Ota CDN:ssä käyttöön sen Markdown-muunnos agenteille, jos sellainen on. Lisää sovelluskehykseen middleware, joka palauttaa Markdown-version, kun Accept-otsake pyytää muotoa text/markdown.
  3. Lähetä Content-Type: text/markdown; charset=utf-8 ja, jos URL on sama kuin HTML-sivulla, Vary: Accept.
  4. Linkitä kopio HTML:n head-osasta elementillä <link rel="alternate" type="text/markdown">, jotta myös agentit, jotka eivät neuvottele sisältömuodosta, löytävät sen.
  5. Vahvista tulos painamalla sivuraportissa ”Tarkista uudelleen”.

Esimerkki

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

Miten korjauksen voi varmistaa

Paina muutoksen jälkeen raportissa "Tarkista uudelleen": se näyttää, mitä korjattiin ja miten pistemäärä muuttui.

Tarkista sivuni →

Aiheeseen liittyvät oppaat

Kaikki havainnot ja miten pistemäärä lasketaan