Verze v Markdownu pro agenty nefunguje

Stručná odpověď

Stránka agentům nabízí verzi v Markdownu, buď jako odpověď na Accept: text/markdown, nebo přes <link rel="alternate" type="text/markdown">, ale tato verze vrací chybu, prázdné tělo nebo stránku HTML. Agenti, kteří si o ni řeknou, nedostanou nic užitečného.

agent.markdown_broken · Priorita: P2

Co to znamená

Stránka agentům nabízí Markdown (jako odpověď na Accept: text/markdown nebo jako odkazovanou kopii), ale vrací chybu, prázdné tělo nebo stránku HTML.

Proč na tom záleží pro AI vyhledávání

Agent, který uvidí odkaz na Markdown nebo dostane odpověď text/markdown, jí věří a nemusí se vrátit k HTML. Rozbitá kopie je horší než žádná: agent buď selže, nebo přečte chybovou stránku jako váš obsah.

Obvykle se to stane po stěhování nebo přestavbě webu: soubory .md se nenasadily, pravidlo pro přepis vede na starou cestu nebo middleware označí HTML jako text/markdown.

Jak to opravit

  1. Otevřete URL z důkazů a podívejte se na stav, Content-Type a tělo odpovědi.
  2. Pokud kopie zmizela, nasaďte ji znovu, nebo odstraňte značku <link rel="alternate" type="text/markdown"> a hlavičku Link, které na ni odkazují.
  3. Pokud je odpověď HTML nebo prázdná, opravte převod tak, aby vracel text stránky jako Markdown s Content-Type: text/markdown.
  4. Na reportu stránky spusťte „Zkontrolovat znovu“ a ověřte výsledek.

Pří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

Jak ověřit opravu

Po změně klikněte ve zprávě na „Zkontrolovat znovu“: uvidíte, co bylo opraveno a jak se změnilo skóre.

Zkontrolovat mou stránku →

Související návody

Všechna zjištění a jak funguje skóre