الانتقال إلى المحتوى الرئيسي

نظرة عامة

يتيح لك 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)

متغيرات البيئة

أضف هذه المتغيرات إلى ملف تهيئة الصدفة الخاص بك (~/.zshrc أو ~/.bashrc) لتبقى ثابتة بين الجلسات:

أمثلة على الاستخدام

تحويل أساسي

يطبع Markdown إلى الإخراج القياسي (stdout).

التمرير إلى نموذج LLM

الحفظ في ملف

تضيف علامة --meta ترويسة YAML تتضمن العنوان، رابط المصدر، عدد الكلمات، عدد الرموز، وقت القراءة، والتاريخ.

المعالجة الدفعية من ملف

أنشئ ملفًا باسم urls.txt:
ثم شغّل:
يُحفظ كل رابط كملف .md منفصل داخل مجلد ./research.

الإدراج في مخزن Obsidian

يحفظ هذا كل صفحة في ~/Documents/MyVault/raw/ ويحدّث ~/Documents/MyVault/INDEX.md بروابط لجميع الصفحات المحوَّلة.

Reddit بمفتاح API

يتطلب Reddit مفتاح API صالحًا. بدونه، ستفشل روابط Reddit بسبب قيود Reddit المضادة للبوتات.

وضع 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) وكيل الذكاء الاصطناعي الخاص بك إلى ./context للحصول على إجابات مبنية على مصادر موثوقة.
ينشئ مخزن أبحاث مفهرسًا وقابلًا للبحث في Obsidian.
يزيل الصور والروابط لتقليل استهلاك الرموز (tokens) عند التمرير إلى نماذج LLM.