Markdown content negotiation — Accept: text/markdown cho AI agent
Tóm tắt
Content negotiation cho phép một URL trả HTML cho trình duyệt và trả markdown cho AI agent gửi Accept: text/markdown. Bản markdown phải là chính trang đó, không phải bản tóm tắt website, và phản hồi phải có Vary: Accept để bộ nhớ đệm không lẫn hai bản.
Giải thích đơn giản
Nhà hàng đưa thực đơn in đẹp cho khách ngồi bàn, và đưa danh sách món dạng chữ cho tài xế giao hàng khi họ xin. Cùng món ăn, hai định dạng. Nếu đưa tài xế tờ giới thiệu nhà hàng thay cho thực đơn thì sai.
Cách hoạt động: content negotiation là một phần của chuẩn HTTP (RFC 9110): client liệt kê định dạng nhận được trong header Accept, server chọn một. Agent thích markdown sẽ gửi Accept: text/markdown (thường kèm text/html để dự phòng). Server trả về Content-Type: text/markdown; charset=utf-8 và Vary: Accept.
Ai đang dùng: Cloudflare ra mắt "Markdown for Agents" ngày 12/2/2026: với zone gói Pro, Business và Enterprise, Cloudflare chuyển HTML sang markdown ngay tại edge khi request yêu cầu, và thêm header ước tính x-markdown-tokens. Cloudflare nêu Claude Code và OpenCode là các agent đã gửi header này. Nhiều trang tài liệu lớn (Cloudflare, Stripe, Vercel, Anthropic) đã hỗ trợ.
Vì sao markdown: cùng một trang tốn ít token hơn nhiều. Cloudflare đo bài thông báo của họ: 16.180 token dạng HTML, 3.150 token dạng markdown, giảm 80%. Menu, script và style bị bỏ; tiêu đề, danh sách, bảng và liên kết vẫn giữ.
Chuẩn liên quan: đặc tả llms.txt gợi ý một bản .md ở URL trang thêm đuôi .md, và header Link: <…>; rel="alternate"; type="text/markdown" có thể trỏ tới bản đó. Negotiation, bản .md và header Link có thể cùng tồn tại.
⚡Tại sao quan trọng
Trợ lý lập trình và AI agent đọc trang để trả lời người dùng ngay lúc đó. Markdown đưa nội dung của bạn cho họ mà không kèm phần khung trang, nên vừa ngữ cảnh hơn. Đây không phải tín hiệu xếp hạng của Google: các tính năng AI của Google đọc chỉ mục HTML bình thường. Hãy coi nó là cách rẻ để agent dùng trang bạn dễ hơn, sau khi đã có phần cơ bản (HTML hiển thị phía server, robots.txt không chặn AI crawler).
🔍CiteStat kiểm tra thế nào
CiteStat gửi request tới chính URL được quét với Accept: text/markdown, text/html, */* (giống agent thật) và chỉ cho đạt khi đủ ba điều: phản hồi là text/markdown, tiêu đề của nó (title: trong front-matter hoặc heading # đầu tiên) là phần mở đầu của H1 hoặc <title> của trang — nên bản tóm tắt site trả cho mọi URL không được tính — và có Vary: Accept. Trả tài liệu khác hoặc thiếu Vary là lỗi mức trung bình. Riêng trang chủ, bản tóm tắt mang tên site được tính là chính trang đó. Để tự kiểm tra một trang, so sánh curl -H 'Accept: text/markdown' <url> với trang thường.
Điểm CiteStat
Là một trong 9 check chính của thẻ Agent Readiness (điểm = số check chính đạt / 9 × 10). Không ảnh hưởng điểm SEO tổng.
Độ khó sửa
Biên tập viên: Khó | Lập trình viên: Trung bình | AI Agent: Trung bình