ForHosting KIT · أدوات المطورين

تحويل السطور إلى قائمة Markdown مرقمة

حوّلوا كتلة من السطور المنفصلة إلى قائمة Markdown مرقمة من دون تحرير كل بند يدوياً.

● Betaمجاني · داخل متصفحك

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

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

جهّزوا بنداً مقصوداً في كل سطر

ابدؤوا بنص عادي يمثّل كل سطر فيه بنداً واحداً من القائمة المرتبة النهائية. يناسب ذلك خطوات التثبيت المنسوخة من الملاحظات، ومعايير القبول المصدّرة من أداة تخطيط، وبنود جدول الأعمال، وتعليمات الوصفات، والإرشادات القصيرة المكتوبة من دون تنسيق. لا تعيد الأداة صياغة المحتوى ولا تلخّصه ولا تغيّر ترتيبه ولا تفسّر معناه. فهي تتعامل مع فاصل السطر بوصفه حداً للبند، وتحافظ على المحارف الموجودة في كل سطر، بما فيها المسافات البادئة التي قد تكون ذات دلالة في مثال تقني. تُوحّد نهايات السطور الخاصة بأنظمة Windows وMac القديمة وUnix قبل المعالجة، لذلك يتصرف المحتوى الملصق بصورة متسقة. يُرفض الإدخال الفارغ تماماً أو المكوّن من مسافات فقط لأنه لا يستطيع إنشاء قائمة مفيدة. وتبقى السطور الفارغة الداخلية بنوداً مرقمة فارغة بدلاً من حذفها بصمت؛ وبذلك لا تغيّر عملية آلية رقم البنود اللاحقة أو موضعها من دون تنبيه. احذفوا السطور الفارغة غير المرغوبة قبل التحويل.

اختاروا موضع بدء الترقيم

تكون العلامة الأولى افتراضياً `1.`، وهي البداية المعتادة لقائمة Markdown مرتبة ومستقلة. يمكنكم إدخال عدد صحيح موجب في الحقل `start` عندما تتابع الكتلة الجديدة تسلسلاً موجوداً في قسم آخر. فإذا بدأتم من 4 مثلاً، تحصل السطور الثلاثة الأولى على `4.` و`5.` و`6.`. يلي كل رقم نقطة ومسافة واحدة، وهي صيغة قائمة مرتبة تدعمها عارضات Markdown على نطاق واسع. يتضمن الناتج سلسلة `markdown` كاملة للنسخ، ومصفوفة `numbered_lines` للبرامج التي تحتاج إلى فحص البنود المفردة أو توجيهها كلٌّ على حدة. كما يعرض `line_count` والقيمة الفعلية للحقل `start`، مما يسهّل عمليات التحقق الآلية. يجب أن تكون قيمة البداية عدداً صحيحاً ضمن النطاق الموثق؛ وتُرفض الكسور والسلاسل الرقمية والصفر والأعداد السالبة بدلاً من تقريبها أو تخمينها. يحافظ هذا العقد الصارم على تطابق النتائج بين مشغّل المتصفح وعملاء API والبرامج النصية وبيئات الاختبار.

استخدموا الناتج في الوثائق والأتمتة

انسخوا قيمة `markdown` الناتجة مباشرة إلى ملف README أو وصف مشكلة أو مقالة في قاعدة معرفة أو ملف مصدر لموقع ثابت أو أي محرر يقبل Markdown. تضيف الأداة علامات القائمة المرتبة فقط، لذلك راجعوا الناتج إذا كان السطر الأصلي يبدأ بالفعل بعلامة تعداد أو رقم؛ فهذه المحارف جزء من محتواكم وتُحفظ عمداً. في سير عمل آلي، أرسلوا النص المصدر ورقم البداية الاختياري، ثم خزّنوا السلسلة الناتجة أو انشروها من دون الحاجة إلى مكتبة Markdown. لا تستخدم العملية طلبات شبكة أو نموذجاً توليدياً أو تاريخاً أو قيمة عشوائية، ولذلك تعيد الطلبات المتطابقة النتيجة نفسها دائماً. يناسب المتصفح مهام التنسيق العرضية، بينما تبلغ كلفة API مقدار $0.002 لكل طلب وتلائم مولدات الوثائق وأدوات الإصدار ومسارات المحتوى. تضمن حدود حجم الإدخال وعدد السطور بقاء التنفيذ منضبطاً. إذا تجاوز المصدر تلك الحدود، فقسّموه إلى أقسام منطقية واضبطوا رقم البداية في كل قسم لاحق للحفاظ على التسلسل المطلوب.

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

تنسيق خطوات الوثائق

حوّلوا سلسلة غير منسقة من خطوات الإعداد أو استكشاف الأخطاء إلى Markdown مرتب وجاهز لملف README أو مقالة دعم.

متابعة إجراء قائم

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

أتمتة مسارات النشر

حوّلوا مخرجات نظام آخر المنظمة حسب السطور إلى Markdown متوقع قبل إدراجها في وثائق مولدة.

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

ما كلفة التحويل؟

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

هل تتغير صياغة السطور؟

لا. تُوحّد الأداة نهايات السطور وتضيف رقماً متزايداً ونقطة ومسافة قبل كل سطر أصلي.

هل يمكن أن تبدأ القائمة برقم غير واحد؟

نعم. أدخلوا عدداً صحيحاً موجباً في `start` لاختيار أول علامة في تسلسل متابع.

ماذا يحدث للسطور الفارغة؟

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

هل يعمل الناتج في عارضات Markdown الشائعة؟

نعم. يستخدم كل بند الصيغة الرقمية القياسية: عدد صحيح، ثم نقطة، ثم مسافة، ثم محتوى السطر.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/markdown-numbered-list

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

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

curl -X POST https://api.kit.forhosting.com/str/markdown-numbered-list \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Install the dependencies\nConfigure the environment\nRun the test suite"}'

const res = await fetch("https://api.kit.forhosting.com/str/markdown-numbered-list", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Install the dependencies\nConfigure the environment\nRun the test suite"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/markdown-numbered-list",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Install the dependencies\nConfigure the environment\nRun the test suite"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/markdown-numbered-list", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Install the dependencies\\nConfigure the environment\\nRun the test suite"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Install the dependencies\nConfigure the environment\nRun the test suite"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/markdown-numbered-list", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "Install the dependencies\nConfigure the environment\nRun the test suite"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_chars`	100000
`max_lines`	10000

الأخطاء

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

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