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

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

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

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

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

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

جهّزوا عنصرًا قابلًا للتنفيذ في كل سطر

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

افهموا صيغة Markdown الناتجة

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

ألصقوا النتيجة أو شغّلوها آليًا بأمان

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

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

إعداد قائمة تحقق لمشكلة

حوّلوا معايير القبول أو خطوات التحقيق إلى مربعات جاهزة لوصف مشكلة.

إنشاء قالب للمراجعة

حوّلوا قائمة أسئلة المراجعة إلى Markdown متسق لطلبات الدمج وملاحظات الإصدار.

تنسيق ملاحظات المشروع

حوّلوا إجراءات الاجتماعات أو ملاحظات التخطيط إلى مهام من دون تعديل كل سطر يدويًا.

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

ما الكلفة؟

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

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

تُتجاهل الأسطر الفارغة أو المكونة من مسافات فقط، فلا تنشئ عناصر بلا محتوى.

هل تُعلّم أي مهام على أنها مكتملة؟

لا. يستخدم كل عنصر مربعًا غير محدد لكي يمكن تسجيل التقدم لاحقًا.

هل يُحفظ ترتيب الأسطر؟

نعم. تظهر الأسطر غير الفارغة بالترتيب نفسه تمامًا في القائمة الناتجة.

هل يمكن أن يتضمن السطر تنسيق Markdown؟

نعم. تُحفظ الروابط والتوكيد والشيفرة المضمنة وغيرها من عناصر Markdown داخل السطر.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/markdown-checklist

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

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

curl -X POST https://api.kit.forhosting.com/str/markdown-checklist \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Review the proposal\nAssign an owner\nSet a due date"}'

const res = await fetch("https://api.kit.forhosting.com/str/markdown-checklist", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Review the proposal\nAssign an owner\nSet a due date"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/markdown-checklist",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Review the proposal\nAssign an owner\nSet a due date"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/markdown-checklist", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Review the proposal\\nAssign an owner\\nSet a due date"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Review the proposal\nAssign an owner\nSet a due date"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/markdown-checklist", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "Review the proposal\nAssign an owner\nSet a due date"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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