ForHosting KIT · النصوص والذكاء الاصطناعي

استخرج روابط Markdown مع النص وعنوان URL

احصل على كل روابط نص Markdown في قائمة مرتبة من النص الظاهر والعنوان: تعطي العينة 4 روابط، من setup guide إلى Home، وتُربط الروابط المرجعية مثل [support][] بعنوانها الحقيقي. مجاناً في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

حوّل مصدر Markdown إلى قائمة مرتبة من الروابط من دون عرض المستند أو إنشاء محلل خاص. تكتشف الأداة الروابط المضمنة والروابط ذات النمط المرجعي، وتحل تعريفاتها، ثم تعيد النص الظاهر مع عنوان URL المقصود وفق ترتيب المصدر. تتجاهل الصور والأمثلة الشبيهة بالروابط داخل الشفرة، وتعيد قائمة فارغة للمستندات التي لا تحتوي على روابط. تتم المعالجة بصورة حتمية ومن دون اتصال بالشبكة، وتناسب ملفات README وصفحات التوثيق وسجلات التغيير وقوالب المشكلات وملفات Markdown المولدة.

استخرج نصوص الروابط ووجهاتها بطلب واحد

ألصق مصدر Markdown الكامل في الحقل <code>text</code>. تحتوي النتيجة على مصفوفة <code>links</code>، ويضم كل سجل قيمة <code>text</code> للتسمية الظاهرة وقيمة <code>url</code> للوجهة. تعاد الروابط المضمنة مثل <code>[الدليل](https://example.com/setup)</code> مباشرة.

يبقى ترتيب القراءة محفوظًا لتتمكن من إجراء التدقيق والترحيل وإعداد التقارير من دون فرز إضافي. تحتفظ النتيجة أيضًا بالتكرارات، لأن كل ظهور قد يكون مهمًا عند مراجعة التنقل أو قياس إبراز وجهة معينة. إذا لم يتضمن Markdown أي رابط مدعوم، ينجح الطلب ويعيد مصفوفة فارغة بدل اعتبار المستند العادي خطأ.

وتعالج المدخلات الفارغة بالطريقة نفسها.

حل المراجع من دون الخلط بينها وبين أمثلة الشفرة

قد تستخدم مراجع Markdown تسميات صريحة أو مطوية أو مختصرة. يدعم المستخرج <code>[التسمية][id]</code> و<code>[التسمية][]</code> و<code>[التسمية]</code> عند وجود تعريف مطابق. تتم مطابقة التسميات من دون اعتبار لحالة الأحرف، كما توحّد مسافات الفراغ المتتابعة.

تقبل الوجهات المحاطة بأقواس زاوية والعناوين الاختيارية في التعريف، لكن العناوين لا تظهر في الناتج لأن القدرة تعيد النص وعنوان URL المطلوبين فقط. تستبعد صيغة الصور التي تبدأ بعلامة تعجب، فمصدر الصورة مورد مضمن وليس رابط تنقل. كما تتجاهل كتل الشفرة المسيجة ومقاطع الشفرة المضمنة حتى لا تلوث الأمثلة التقنية قائمة الروابط الحقيقية.

لا ينتج سطر التعريف سجلًا بمفرده، بل تدرج الاستخدامات الفعلية فقط. تزال علامات التنسيق من النص الظاهر، وتستعاد علامات ترقيم Markdown المهروبة لتقديم قيمة عملية للمعالجة اللاحقة.

استخدم الروابط المنظمة في مسارات عمل التوثيق

تفيد قائمة الروابط قبل نقل التوثيق أو تغيير نطاق أو البحث عن إشارات إلى خدمات متوقفة. يمكنك إرسال كل عنوان URL إلى مرحلة تحقق معتمدة، أو تجميع الوجهات حسب المضيف، أو مقارنة نسختين لمعرفة الروابط المضافة والمحذوفة. تستطيع فرق المحتوى العثور على التسميات المبهمة، بينما تستطيع فرق التطوير اكتشاف المراجع المتكررة في ملفات README المولدة.

تجعل هذه الحدود التنفيذ سريعًا وخاصًا ومتوقعًا، إذ ينتج الإدخال نفسه دائمًا الناتج المرتب نفسه. يقتصر الإدخال على مليون محرف لضبط وقت المعالجة.

حالات الاستخدام

دقق وجهات التوثيق

أنشئ قائمة مرتبة بعناوين URL الخاصة بالتنقل قبل فحص التوفر أو الملكية أو الاستعداد للترحيل.

راجع تسميات الروابط

افحص النص الظاهر لاكتشاف التسميات المبهمة وتحسين وضوح التوثيق وإمكانية الوصول إليه.

قارن نسخ Markdown

استخرج الروابط من نسختين وحدد الوجهات التي أضيفت أو استبدلت أو حذفت.

الأسئلة الشائعة

ما صيغ الروابط المدعومة؟

تدعم الروابط المضمنة والمراجع الكاملة والمطوية والمختصرة عند وجود تعريفاتها.

هل تشمل النتيجة صور Markdown؟

لا. تستبعد صيغة الصور لأن القدرة تستخرج روابط التنقل لا مصادر الموارد المضمنة.

ماذا يحدث إذا لم يحتوِ المستند على روابط؟

تحصل على قائمة فارغة لا على خطأ. فالنص الخالي من الروابط مستند عادي، وبذلك تميّز الفحوص الآلية بينه وبين إدخال معطوب وتواصل عملها.

هل تُحسب الروابط الموجودة داخل أمثلة الكود؟

لا. تُتجاوز كتل الكود والكود المضمّن في السطر، فلا تُفسد أمثلة Markdown في الدروس قائمة روابطك الحقيقية. ولا تظهر الأسطر التي تعرّف مرجعاً فقط، بل الاستخدامات الفعلية وحدها.

هل تتحقق الأداة من أن الروابط ما زالت تعمل؟

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

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/dev2/markdown-link-extract

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/dev2/markdown-link-extract \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Read the [guide](https://example.com/guide) and [API docs][api].\n\n[api]: https://example.com/api"}'

const res = await fetch("https://api.kit.forhosting.com/dev2/markdown-link-extract", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Read the [guide](https://example.com/guide) and [API docs][api].\n\n[api]: https://example.com/api"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev2/markdown-link-extract",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Read the [guide](https://example.com/guide) and [API docs][api].\n\n[api]: https://example.com/api"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/markdown-link-extract", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Read the [guide](https://example.com/guide) and [API docs][api].\\n\\n[api]: https://example.com/api"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Read the [guide](https://example.com/guide) and [API docs][api].\n\n[api]: https://example.com/api"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/markdown-link-extract", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "Read the [guide](https://example.com/guide) and [API docs][api].\n\n[api]: https://example.com/api"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.markdown_link_extract",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_chars 1000000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

استخرج نصوص الروابط ووجهاتها بطلب واحد

أما الروابط المرجعية مثل <code>[API][docs]</code> فتطابق تعريفات مثل <code>[docs]: https://example.com/api</code> حتى إذا ورد التعريف لاحقًا في المستند.

استخدم الروابط المنظمة في مسارات عمل التوثيق

لا تزور القدرة عناوين URL، ولا تختبر حالة HTTP، ولا تتبع عمليات إعادة التوجيه، ولا تعدل Markdown. يؤدي غياب الحقل <code>text</code> أو عدم كونه سلسلة إلى الخطأ <code>invalid_input</code>، وبذلك يمكن التمييز بين طلب غير صالح ومستند صحيح بلا روابط. تبلغ تكلفة طلب API الواحد $0.002.

أسئلة تقنية

ماذا يحدث عند عدم وجود روابط؟

ينجح الطلب ويعيد مصفوفة <code>links</code> فارغة.

هل تتحقق الأداة من عمل عنوان URL؟

لا. تستخرج الوجهات من دون طلبات شبكة أو تتبع لإعادة التوجيه أو اختبار لحالة HTTP.

ما تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن للمنفذ في المتصفح تشغيل الاستخراج الحتمي نفسه محليًا.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

استخرج نصوص الروابط ووجهاتها بطلب واحد

حل المراجع من دون الخلط بينها وبين أمثلة الشفرة

استخدم الروابط المنظمة في مسارات عمل التوثيق

حالات الاستخدام

دقق وجهات التوثيق

راجع تسميات الروابط

قارن نسخ Markdown

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

استخرج نصوص الروابط ووجهاتها بطلب واحد

استخدم الروابط المنظمة في مسارات عمل التوثيق

أسئلة تقنية

شكرًا