md-to-text-skill: دليل عملي للوكلاء

إذا كنت تبني مسار عمل Agent يحتاج تحويل Markdown إلى نص عادي بشكل ثابت، فإن md-to-text-skill خيار مناسب جدًا.

المستودع: MD-TO-TEXT/md-to-text-skill

Quick answer

استخدم md-to-text-skill عندما تحتاج تحويل ملف واحد بنتيجة متوقعة مع fallback تلقائي بين بيئات التشغيل.

ماذا يقدّم هذا skill

• تحويل ملف Markdown واحد إلى نص عادي.
• تنفيذان متاحان: Python و Node.
• مشغّل موحّد: scripts/run.js.
• إزالة علامات Markdown مع الحفاظ على قابلية القراءة.

الأمر الأساسي

node scripts/run.js <input.md> [--mode readable|minimal|structured] [-o output.txt] [--stdout]

أنماط الإخراج

• readable (الافتراضي): نص أكثر وضوحًا للقراءة.
• minimal: إخراج مضغوط.
• structured: يحافظ على بنية العناوين/القوائم بدون رموز Markdown.

ترتيب fallback لبيئة التشغيل

1. python3
2. python
3. node

إذا لم تتوفر أي بيئة، ينتهي التنفيذ برمز 2 مع إرشادات للتثبيت.

لماذا يفيد في مسارات الوكلاء

• نتيجة مستقرة للخطوات اللاحقة.
• مرونة أعلى عبر بيئات مختلفة.
• خيار --stdout مفيد للربط المباشر في الطرفية.

المسار المقترح داخل هذا الموقع

• فحص العرض: Markdown Preview
• التحويل إلى نص عادي: Markdown to Plain Text
• متابعة مسار التصدير: Markdown Export Hub

ابدأ بـ Markdown to Plain Text ثم اختر readable أو minimal أو structured حسب هدفك.

FAQ

هل يدعم تحويل عدة ملفات دفعة واحدة؟

الإصدار الحالي يركّز على ملف واحد في كل مرة.

هل يمكن الطباعة إلى الطرفية فقط؟

نعم، باستخدام --stdout.

لماذا يوجد تنفيذ Python و Node معًا؟

لتحسين التوافق عبر البيئات المختلفة.