Verzia v Markdowne pre agentov nefunguje

Krátka odpoveď

Stránka agentom ponúka verziu v Markdowne, buď ako odpoveď na Accept: text/markdown, alebo cez <link rel="alternate" type="text/markdown">, ale táto verzia vracia chybu, prázdne telo alebo stránku HTML. Agenti, ktorí si o ňu požiadajú, nedostanú nič užitočné.

agent.markdown_broken · Priorita: P2

Čo to znamená

Stránka agentom ponúka Markdown (ako odpoveď na Accept: text/markdown alebo ako odkazovanú kópiu), ale vracia chybu, prázdne telo alebo stránku HTML.

Prečo je to dôležité pre AI vyhľadávanie

Agent, ktorý uvidí odkaz na Markdown alebo dostane odpoveď text/markdown, jej verí a nemusí sa vrátiť k HTML. Pokazená kópia je horšia ako žiadna: agent buď zlyhá, alebo prečíta chybovú stránku ako váš obsah.

Zvyčajne sa to stane po sťahovaní alebo prestavbe webu: súbory .md sa nenasadili, pravidlo prepisu vedie na starú cestu alebo middleware označí HTML ako text/markdown.

Ako to opraviť

  1. Otvorte URL z dôkazov a pozrite sa na stavový kód, Content-Type a telo odpovede.
  2. Ak kópia zmizla, nasaďte ju znova alebo odstráňte značku <link rel="alternate" type="text/markdown"> a hlavičku Link, ktoré na ňu odkazujú.
  3. Ak je odpoveď HTML alebo prázdna, opravte prevod tak, aby vracal text stránky ako Markdown s Content-Type: text/markdown.
  4. V správe o stránke spustite „Skontrolovať znova“ a overte výsledok.

Príklad

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept

Ako overiť opravu

Po zmene stlačte v správe „Skontrolovať znova“: uvedie, čo sa opravilo a ako sa zmenilo skóre.

Skontrolovať moju stránku →

Súvisiace návody

Všetky zistenia a ako funguje skóre