نسخه Markdown برای عامل‌ها خراب است

پاسخ کوتاه

صفحه یک نسخه Markdown به عامل‌ها ارائه می‌کند، از طریق پاسخ به Accept: text/markdown یا یک <link rel="alternate" type="text/markdown">، اما آن نسخه خطا، بدنه خالی یا یک صفحه HTML برمی‌گرداند. عامل‌هایی که آن را درخواست می‌کنند چیز مفیدی نمی‌گیرند.

agent.markdown_broken · اولویت: P2

یعنی چه

صفحه به عامل‌ها Markdown ارائه می‌کند (در پاسخ به Accept: text/markdown یا به‌صورت نسخه پیوندشده)، اما آنچه برمی‌گردد خطا، بدنه خالی یا یک صفحه HTML است.

چرا برای جستجوی هوش مصنوعی مهم است

عاملی که پیوند Markdown را می‌بیند یا پاسخی با text/markdown می‌گیرد به آن اعتماد می‌کند و ممکن است به HTML برنگردد. نسخه خراب از نبودِ نسخه بدتر است: عامل یا شکست می‌خورد یا یک صفحه خطا را به‌عنوان محتوای شما می‌خواند.

این معمولاً پس از جابه‌جایی یا بازسازی سایت پیش می‌آید: فایل‌های .md مستقر نشده‌اند، یک قانون rewrite به مسیر قدیمی اشاره می‌کند، یا یک middleware صفحه HTML را text/markdown برچسب می‌زند.

چطور آن را اصلاح کنید

  1. URL موجود در شواهد را باز کنید و وضعیت، Content-Type و بدنه را ببینید.
  2. اگر نسخه از بین رفته، دوباره مستقرش کنید یا تگ <link rel="alternate" type="text/markdown"> و هدر Link را که به آن اشاره می‌کنند حذف کنید.
  3. اگر پاسخ HTML یا خالی است، تبدیل را اصلاح کنید تا متن صفحه را به‌صورت Markdown با Content-Type: text/markdown برگرداند.
  4. در گزارش صفحه «بررسی دوباره» را اجرا کنید تا نتیجه را تأیید کنید.

نمونه

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

چطور از رفع مشکل مطمئن شویم

پس از اعمال تغییر، در گزارش «بررسی دوباره» را بزنید: فهرست می‌کند چه چیزی رفع شده و امتیاز چطور تغییر کرده است.

بررسی صفحه من ←

راهنماهای مرتبط

همه یافته‌ها و نحوه محاسبه امتیاز