نظرة عامة
يتيح لك CLI الخاص بـ Web2MD تحويل أي رابط إلى Markdown نظيف مباشرة من الطرفية (Terminal). مرّر المخرجات إلى نماذج LLM، أو عالج قوائم روابط دفعة واحدة، أو أدرج المحتوى في مخزن Obsidian الخاص بك — كل ذلك دون فتح متصفح.يتطلب CLI إصدار Node.js 18 أو أحدث. شغّل
node -v للتحقق من إصدارك.التثبيت
لا حاجة لأي تثبيت — فقط شغّله باستخدامnpx:
أوضاع التشغيل
يعمل CLI الخاص بـ Web2MD بثلاثة أوضاع حسب إعداداتك:محلي
الوضع الافتراضي. لا يتطلب مفتاح API. يجلب الصفحات ويحوّلها محليًا. يعمل مع معظم المواقع العامة.
خادم (Server)
مع مفتاح API. اضبط
WEB2MD_API_KEY لفتح دعم Reddit وFandom/Wikia وغيرها من المواقع المقيَّدة التي تتطلب معالجة من جهة الخادم.جسر (Bridge)
مع علامة
--bridge. يستخدم إضافة Chrome لجلب الصفحات التي تُعرَض عبر JS أو المحمية بتسجيل دخول والتي لا يمكن للجلب الثابت الوصول إليها.العلامات (Flags)
متغيرات البيئة
أمثلة على الاستخدام
تحويل أساسي
التمرير إلى نموذج LLM
الحفظ في ملف
--meta ترويسة YAML تتضمن العنوان، رابط المصدر، عدد الكلمات، عدد الرموز، وقت القراءة، والتاريخ.
المعالجة الدفعية من ملف
أنشئ ملفًا باسمurls.txt:
.md منفصل داخل مجلد ./research.
الإدراج في مخزن Obsidian
~/Documents/MyVault/raw/ ويحدّث ~/Documents/MyVault/INDEX.md بروابط لجميع الصفحات المحوَّلة.
Reddit بمفتاح API
وضع Bridge
استخدم إضافة Chrome للتعامل مع الصفحات المعروضة عبر JS أو المحمية بتسجيل دخول:يتطلب وضع Bridge تثبيت إضافة Web2MD لمتصفح Chrome وتشغيل Chrome. يتواصل CLI مع الإضافة عبر بروتوكول المراسلة الأصلي (native messaging) الخاص بـ Chrome.
إخراج JSON
jq:
المواقع المُحسَّنة
يتضمن Web2MD محوّلات مدمجة لهذه المواقع، ما ينتج مخرجات أنظف من التحويل العام:المواقع ذات الدعم المُحسَّن
المواقع ذات الدعم المُحسَّن
- Wikipedia — استخراج نظيف للمقالات، ومعالجة صناديق المعلومات (infobox)
- arXiv — ملخصات الأبحاث وبياناتها الوصفية
- Hacker News — المواضيع مع التعليقات
- GitHub — الـ Issues والـ Pull Requests
- Stack Overflow — الأسئلة والأجوبة
- dev.to — تدوينات المطورين
- Medium — المقالات (يتجاوز معاينة الاشتراك المدفوع)
- Substack — منشورات النشرات البريدية
- OpenAI Docs — صفحات التوثيق
- مواقع التوثيق المبنية على Mintlify — مواقع التوثيق المبنية على Mintlify
- Reddit — المنشورات والتعليقات (يتطلب مفتاح API)
سير عمل شائعة
تغذية وكيل الذكاء الاصطناعي بالتوثيق
تغذية وكيل الذكاء الاصطناعي بالتوثيق
./context للحصول على إجابات مبنية على مصادر موثوقة.بناء مجموعة بحثية
بناء مجموعة بحثية
إزالة التنسيق لإدخال LLM
إزالة التنسيق لإدخال LLM