Bản Markdown cho tác tử bị hỏng

Trả lời ngắn

Trang cung cấp bản Markdown cho tác tử, qua câu trả lời cho Accept: text/markdown hoặc qua <link rel="alternate" type="text/markdown">, nhưng bản đó trả về lỗi, nội dung rỗng hoặc một trang HTML. Tác tử yêu cầu nó không nhận được gì hữu ích.

agent.markdown_broken · Mức ưu tiên: P2

Ý nghĩa

Trang cung cấp Markdown cho tác tử (khi trả lời Accept: text/markdown hoặc qua một bản sao được liên kết), nhưng thứ nhận về là lỗi, nội dung rỗng hoặc một trang HTML.

Vì sao điều này quan trọng với tìm kiếm AI

Tác tử thấy liên kết Markdown hoặc nhận được câu trả lời text/markdown sẽ tin vào nó và có thể không quay lại HTML. Một bản sao hỏng còn tệ hơn không có: tác tử hoặc thất bại, hoặc đọc trang lỗi như thể đó là nội dung của bạn.

Việc này thường xảy ra sau khi chuyển site hoặc dựng lại: các tệp .md chưa được triển khai, một quy tắc rewrite trỏ đến đường dẫn cũ, hoặc một middleware gắn nhãn HTML là text/markdown.

Cách khắc phục

  1. Mở URL trong bằng chứng và xem mã trạng thái, Content-Type và nội dung trả về.
  2. Nếu bản sao không còn, hãy triển khai lại nó hoặc xóa thẻ <link rel="alternate" type="text/markdown"> và header Link trỏ đến nó.
  3. Nếu câu trả lời là HTML hoặc rỗng, hãy sửa bước chuyển đổi để nó trả về văn bản của trang dưới dạng Markdown với Content-Type: text/markdown.
  4. Chạy "Kiểm tra lại" trên báo cáo trang để xác nhận kết quả.

Ví dụ

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

Cách xác nhận đã khắc phục

Sau khi thay đổi, nhấn "Kiểm tra lại" trên báo cáo: báo cáo liệt kê những gì đã khắc phục và điểm thay đổi ra sao.

Kiểm tra trang của tôi →

Hướng dẫn liên quan

Tất cả phát hiện và cách tính điểm