gindex / المدونة

المدونة / WP Markdown

موقعك لا يدعم Markdown للوكلاء؟ هكذا تصلح ذلك في ووردبريس

١٨ أكتوبر ٢٠٢٦ · 3 دقائق قراءة

فحصت موقعك على isitagentready.com، وفتحت قسم Content، فوجدت سطرًا أحمر: Site does not support Markdown for Agents. هذه النتيجة طبيعية في مواقع ووردبريس، ويمكن إصلاحها. يشرح هذا الدليل ما الذي يختبره الفحص فعلًا، ولماذا يفشل فيه ووردبريس دون إضافات، وكيف تجتازه.

ما الذي يرسله الفحص

تطلب أداة الفحص صفحتك كما يطلبها وكيل الذكاء الاصطناعي، مع ترويسة إضافية واحدة:

GET /your-post/
Accept: text/markdown

معنى هذه الترويسة: «إذا كانت لديك هذه الصفحة بصيغة Markdown فأنا أفضّلها». وينجح الفحص عندما يأتي الرد بالترويسة:

content-type: text/markdown

ويبحث الفحص أيضًا عن ترويسة x-markdown-tokens، وهي تقدير لعدد الرموز (tokens) في نسخة Markdown، إن كان الموقع يرسلها. أما إذا جاء الرد بـ content-type: text/html فيفشل الفحص بالرسالة التي رأيتها.

لماذا يفشل ووردبريس

لدى ووردبريس طريقة واحدة للرد على طلب صفحة: يشغّل القالب ويرسل HTML. ولا يقرأ ترويسة Accept، فيحصل الوكيل الذي يطلب Markdown على الصفحة نفسها التي يحصل عليها المتصفح، بما فيها رأس الصفحة والقوائم والسكربتات والتذييل حول مقالك.

والمشكلة ليست في أداة الفحص فقط. في مقال تجريبي على قالب ووردبريس الافتراضي كانت صفحة HTML بحجم 152,958 بايت، بينما كان المقال نفسه بصيغة Markdown 1,719 بايت. وأداة الذكاء الاصطناعي التي تقرأ HTML عليها أن تستخرج المقال من كل ما حوله.

ثلاث طرق لاجتياز الفحص

1. إضافة تردّ بصيغة Markdown

تمنح WP Markdown كل مقالة وصفحة نسخة Markdown على عنوانها نفسه مع .md في آخره (العنوان /your-post/ يردّ أيضًا على /your-post.md)، وتردّ كذلك على طلب Accept: text/markdown على العنوان العادي. وهذا شكل الرد الناجح:

200 OK
content-type: text/markdown; charset=utf-8
x-markdown-tokens: 430
vary: Accept

ويبقى المتصفح يحصل على HTML. وتضيف الإضافة أيضًا ترويسة Link إلى كل صفحة HTML تشير إلى نسختها بصيغة Markdown، وهذا ما يبحث عنه فحص Link headers في قسم الاكتشاف (Discoverability). وتعمل مع القوالب الحديثة والكلاسيكية وElementor وACF ومنتجات WooCommerce.

2. التحويل على شبكة التوزيع

إذا كان موقعك خلف Cloudflare على خطة مدفوعة (Pro أو Business أو Enterprise)، يمكنك تفعيل Markdown for Agents من قسم AI Crawl Control. وبعدها تحوّل Cloudflare صفحات HTML إلى Markdown على خوادمها كلما طلب الزائر ذلك، وتردّ بـ content-type: text/markdown وvary: accept. وقبل التحويل تحذف رأس الصفحة والتذييل والقوائم والسكربتات والتنسيقات.

وهناك أمران يجب أن تعرفهما: التحويل يعمل على صفحة HTML النهائية، فكل ما يطبعه قالبك غير ذلك، مثل الشريط الجانبي والتعليقات وأزرار المشاركة وقسم «مقالات ذات صلة»، يبقى في النسخة ما لم يكن داخل الأجزاء التي تُحذف. وإذا لم يرسل خادمك ترويسة content-signal، تضيف Cloudflare القيمة ai-train=yes, search=yes, ai-input=yes نيابة عنك. لذلك اختبر النتيجة على عدد من صفحاتك.

3. كود خاص بك

يستطيع المطوّر أن يتدخل مبكرًا في الطلب عبر template_redirect، فيقرأ ترويسة Accept ويرسل نسخة Markdown من المقال. وهناك ثلاث تفاصيل يسهل نسيانها:

  • ردّ بـ Markdown فقط عندما يكون مفضّلًا. المتصفح يرسل text/html أولًا، فلا تبدّل الرد إلا عندما تكون أولوية text/markdown مساوية لـ text/html أو أعلى.
  • أرسل Vary: Accept. بدونها قد يحفظ نظام التخزين المؤقت رد Markdown ويقدّمه للمتصفح التالي، أو العكس.
  • أبعده عن إضافات التخزين المؤقت. أغلب إضافات الكاش في ووردبريس تعتمد على العنوان وحده، فاجعل رد Markdown غير قابل للتخزين عندها.

تأكّد أن الإصلاح يعمل

يمكنك أن تختبر بنفسك قبل أن تفحص من جديد:

curl -sI -H "Accept: text/markdown" https://yoursite.com/your-post/

ابحث في الرد عن content-type: text/markdown، ثم أعد الفحص على isitagentready.com.

افحص مقالًا أو صفحة، وليس الصفحة الرئيسية فقط. إذا كانت صفحتك الرئيسية قائمة بأحدث المقالات، فلا يوجد مقال واحد يتحوّل إلى Markdown، ويبقى الرد عليها HTML حتى مع إعداد صحيح.

هل يؤثر هذا على ظهوري في Google؟

لا، ما دامت نسخة Markdown تشير إلى الأصل. ترسل WP Markdown مع كل رد بصيغة Markdown الترويسة Link: <your page>; rel="canonical"، فتبقى صفحة HTML التي يراها زوارك هي التي ترتّبها محركات البحث. ولا تضع noindex على نسخة Markdown، لأن بعض زواحف الذكاء الاصطناعي تلتزم بها أيضًا، فيضيع الهدف.

الخلاصة

يسأل فحص Markdown سؤالًا واحدًا: عندما يطلب الوكيل Markdown، هل يحصل عليه؟ وجواب ووردبريس الافتراضي «لا». ويمكن أن تغيّر الجواب إلى «نعم» بإضافة مثل WP Markdown، أو بالتحويل على شبكة التوزيع، أو بكود خاص بك. وأيًّا كان اختيارك، أرسل Vary: Accept، وأبقِ المتصفح على HTML، واختبر مقالًا حقيقيًا.

← WP Markdown · كل المقالات