Không có bản Markdown cho tác tử AI

Trả lời ngắn

Khi trang được yêu cầu với Accept: text/markdown, máy chủ gửi HTML, và trang không liên kết bản Markdown nào. Khi đó tác tử AI phải đọc toàn bộ HTML, kể cả menu, footer và script. Cung cấp bản Markdown là tùy chọn: đây là một quy ước còn mới, nên mức ưu tiên là P3.

agent.no_markdown · Mức ưu tiên: P3

Ý nghĩa

Khi được yêu cầu với Accept: text/markdown, trang trả về HTML và không liên kết bản Markdown nào (<link rel="alternate" type="text/markdown">). Khi đó tác tử phải đọc toàn bộ HTML, kể cả menu và script. Tùy chọn: Markdown cho tác tử là một quy ước còn mới, chưa phải tiêu chuẩn.

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

Tác tử duyệt web thay người dùng (và các công cụ nạp trang vào ngữ cảnh của mô hình) làm việc với văn bản, không phải bố cục. Bản Markdown gọn của một trang nhỏ hơn HTML nhiều lần mà vẫn giữ các tiêu đề, danh sách và liên kết quan trọng. Một số CDN và framework đã trả lời Accept: text/markdown bằng bản như vậy, và llmstxt.org đề xuất đặt một bản .md cạnh mỗi trang.

Không có nó cũng không hỏng gì: trình thu thập vẫn đọc HTML. Đây là cải tiến rẻ sau khi đã sửa các phát hiện về truy cập, robots.txt và nội dung.

Cách khắc phục

  1. Chọn một cách phục vụ Markdown: trả lời Accept: text/markdown ngay tại URL của trang, hoặc công bố một bản sao như /guide/index.md.
  2. Trên CDN, bật tính năng chuyển sang Markdown cho tác tử nếu có. Trong framework, thêm middleware trả về bản Markdown khi header Accept yêu cầu text/markdown.
  3. Gửi Content-Type: text/markdown; charset=utf-8 và, khi URL trùng với trang HTML, gửi thêm Vary: Accept.
  4. Liên kết bản sao từ phần head của HTML bằng <link rel="alternate" type="text/markdown">, để cả tác tử không thương lượng nội dung cũng tìm thấy nó.
  5. Chạy "Kiểm tra lại" trên báo cáo trang để xác nhận kết quả.

Ví dụ

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

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