AI ایجنٹس کے لیے کوئی Markdown ورژن نہیں

مختصر جواب

Accept: text/markdown کے ساتھ صفحہ مانگنے پر سرور نے HTML بھیجا، اور صفحہ کسی Markdown کاپی سے لنک نہیں کرتا۔ پھر AI ایجنٹس پورا HTML پڑھتے ہیں، مینو، فوٹر اور اسکرپٹس سمیت۔ Markdown ورژن دینا اختیاری ہے: یہ ایک نیا رواج ہے، اس لیے یہ P3 ہے۔

agent.no_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 اور مواد کے نتائج درست ہو جانے کے بعد یہ ایک سستی بہتری ہے۔

اسے کیسے ٹھیک کریں

  1. Markdown دینے کا ایک طریقہ چنیں: صفحے کے اپنے URL پر Accept: text/markdown کا جواب دیں، یا /guide/index.md جیسی کاپی شائع کریں۔
  2. CDN پر، اگر اس میں ایجنٹس کے لیے Markdown کنورژن موجود ہو تو اسے آن کریں۔ فریم ورک میں ایسا middleware شامل کریں جو Accept ہیڈر کے text/markdown مانگنے پر Markdown ورژن لوٹائے۔
  3. Content-Type: text/markdown; charset=utf-8 بھیجیں، اور جب URL وہی ہو جو HTML صفحے کا ہے تو Vary: Accept بھی۔
  4. HTML کے head سے <link rel="alternate" type="text/markdown"> کے ذریعے کاپی کا لنک دیں، تاکہ جو ایجنٹس فارمیٹ طے نہیں کرتے وہ بھی اسے ڈھونڈ سکیں۔
  5. یہ تصدیق کرنے کے لیے کہ مسئلہ حل ہو گیا، صفحے کی رپورٹ پر "دوبارہ جانچیں" چلائیں۔

مثال

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

حل کی تصدیق کیسے کریں

تبدیلی کے بعد رپورٹ پر "دوبارہ جانچیں" دبائیں: یہ بتاتی ہے کہ کیا درست ہوا اور اسکور کیسے بدلا۔

میرا صفحہ جانچیں ←

متعلقہ گائیڈز

تمام نتائج اور اسکور کیسے کام کرتا ہے