AI ایجنٹس کے لیے کوئی Markdown ورژن نہیں
Accept: text/markdown کے ساتھ صفحہ مانگنے پر سرور نے HTML بھیجا، اور صفحہ کسی Markdown کاپی سے لنک نہیں کرتا۔ پھر AI ایجنٹس پورا HTML پڑھتے ہیں، مینو، فوٹر اور اسکرپٹس سمیت۔ Markdown ورژن دینا اختیاری ہے: یہ ایک نیا رواج ہے، اس لیے یہ P3 ہے۔
اس کا کیا مطلب ہے
Accept: text/markdown کے ساتھ درخواست پر صفحے نے HTML لوٹایا، اور یہ کسی Markdown کاپی سے لنک نہیں کرتا (<link rel="alternate" type="text/markdown">)۔ پھر ایجنٹس پورا HTML پڑھتے ہیں، مینو اور اسکرپٹس سمیت۔ اختیاری: ایجنٹس کے لیے Markdown ایک نیا رواج ہے، معیار نہیں۔
AI سرچ کے لیے یہ کیوں اہم ہے
جو ایجنٹس صارف کے لیے براؤز کرتے ہیں (اور جو ٹولز صفحات کو ماڈل کے context میں لوڈ کرتے ہیں) متن کے ساتھ کام کرتے ہیں، لے آؤٹ کے ساتھ نہیں۔ کسی صفحے کا صاف Markdown ورژن اس کے HTML سے کئی گنا چھوٹا ہوتا ہے اور اہم ہیڈنگز، فہرستیں اور لنکس برقرار رکھتا ہے۔ کچھ CDNs اور فریم ورکس پہلے ہی Accept: text/markdown کا جواب ایسے ورژن سے دیتے ہیں، اور llmstxt.org ہر صفحے کے ساتھ ایک .md کاپی تجویز کرتا ہے۔
اس کے بغیر کچھ نہیں ٹوٹتا: کرالرز پھر بھی HTML پڑھتے ہیں۔ رسائی، robots.txt اور مواد کے نتائج درست ہو جانے کے بعد یہ ایک سستی بہتری ہے۔
اسے کیسے ٹھیک کریں
- Markdown دینے کا ایک طریقہ چنیں: صفحے کے اپنے URL پر
Accept: text/markdownکا جواب دیں، یا/guide/index.mdجیسی کاپی شائع کریں۔ - CDN پر، اگر اس میں ایجنٹس کے لیے Markdown کنورژن موجود ہو تو اسے آن کریں۔ فریم ورک میں ایسا middleware شامل کریں جو
Acceptہیڈر کےtext/markdownمانگنے پر Markdown ورژن لوٹائے۔ Content-Type: text/markdown; charset=utf-8بھیجیں، اور جب URL وہی ہو جو HTML صفحے کا ہے توVary: Acceptبھی۔- HTML کے head سے
<link rel="alternate" type="text/markdown">کے ذریعے کاپی کا لنک دیں، تاکہ جو ایجنٹس فارمیٹ طے نہیں کرتے وہ بھی اسے ڈھونڈ سکیں۔ - یہ تصدیق کرنے کے لیے کہ مسئلہ حل ہو گیا، صفحے کی رپورٹ پر "دوبارہ جانچیں" چلائیں۔
مثال
<!-- 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 حل کی تصدیق کیسے کریں
تبدیلی کے بعد رپورٹ پر "دوبارہ جانچیں" دبائیں: یہ بتاتی ہے کہ کیا درست ہوا اور اسکور کیسے بدلا۔