عبدالله خطاطبة

ببني منتجات بالذكاء الاصطناعي

واتساب
انتقل للمحتوى
كل الهدايا
دليلinstagram28 يوليو 20263 د قراءة

دليل MarkItDown الكامل

أداة مايكروسوفت المجانية اللي بتوفّر 70% من توكنز Claude وتخلي إجاباته أحسن.

كل صفحة PDF بتكلّف بين 1,500 و 3,000 توكن — ملف 20 صفحة بياكل 70,000 توكن قبل ما تسأل سؤال واحد. MarkItDown بيحوّل أي ملف لـ markdown نظيف، فيقّص استهلاكك وحتى يخلي Claude يفهم المحتوى أحسن لأنه متدرّب على ملايين ملفات الـ markdown.

من PDF ثقيل لـ markdown نظيف

📦INSTALL
🔄CONVERT
⬆️UPLOAD
MCP AUTO
SAVE 70% TOKENS

ليش هاد الأداة مهمة

لما ترفع PDF على Claude، بياكل كل صفحة آلاف التوكنز بس عشان يقراه. ملف 20 صفحة ممكن يوصل 70,000 توكن قبل ما ترد عليه. MarkItDown بيحوّل الملف لنص markdown نظيف بنفس المحتوى بس بكسر من التوكنز — وحتى Claude بيجاوب أحسن لأنه بيفهم الـ markdown بشكل طبيعي.

قبل ما تبلّش

تأكد من هالأشياء

  • Python 3.10+ على جهازك (MarkItDown بيشتغل عليه).
  • pip يشتغل بـ terminal بدون مشاكل.
  • Claude Desktop متثبّت (مطلوب بس لخطوة الـ MCP التلقائية).

الخطوات

أربع خطوات من التثبيت للأتمتة

1

Step 1

حمّل الريبو

روح على github.com/microsoft/markitdown — هاد الريبو الرسمي تبع مايكروسوفت وعنده أكتر من 110,000 نجمة. اقرأ الـ README عشان تعرف شو بيوفر.

يدعم كل شي

MarkItDown بيتعامل مع PDFs و Word و Excel و PowerPoint و صور و صوت و HTML و ZIP files وحتى روابط YouTube. أداة وحدة لكل شي كنت رافعه على Claude خام.

2

Step 2

ثبّت MarkItDown

افتح الـ terminal وفعّل أمر التثبيت. الجزء [all] بينزّل دعم كل أنواع الملفات عشان ما تضطر ترجع تنزّل شي بعدين.

pip install 'markitdown[all]'
3

Step 3

حوّل أول ملف

صوّب الأداة على أي ملف واكتب الناتج كملف markdown. هلق ارفع document.md على Claude بدل الـ PDF — نفس المحتوى، بس بكسر من التوكنز.

markitdown document.pdf -o document.md
4

Step 4

خلّيه تلقائي عبر MCP

هي الخطوة اللي بتخلّي كل شي يصير أوتوماتيك داخل Claude Desktop. نزّل خادم الـ MCP، بعدين افتح Claude DesktopSettingsDeveloperEdit Config عشان تفتح ملف claude_desktop_config.json. ضيف MarkItDown لقسم mcpServers:

{
  "mcpServers": {
    "markitdown": {
      "command": "markitdown-mcp"
    }
  }
}

ملاحظة

استخدم كتلة الـ config بالضبط من README تبع الريبو لو اختلفت عن اللي فوق. نسخة الـ README هي المصدر الحقيقي وبتتحدّث باستمرار.

قائمة التحقق

تأكد إن كل شي يشتغل قبل ما تكمل

  • markitdown يشتغل بالـ terminal بدون خطأ command not found.
  • تحويل PDF تجريبي بينتج ملف .md نظيف بنص مقروء.
  • Claude Desktop بيعرض أداة MarkItDown بقائمة الأدوات بعد إعادة التشغيل.
  • رفع نسخة الـ .md بيستخدم توكنز أقل بوضوح من الـ PDF الأصلي.

حل المشاكل

إذا واجهت أي شي

  • markitdown command not found

    التثبيت ما وصل للـ PATH. أعِد تشغيل pip install وأعد فتح الـ terminal.

  • PDF conversion errors

    نزّلت النسخة الأساسية فقط. أعِد التثبيت مع pip install 'markitdown[all]' عشان تحصل على كل المحوّلات.

  • Claude Desktop ما بيظهر الأداة

    بأ غالب الظن الـ JSON فيه خطأ أو ما أعدت تشغيل Claude بالكامل. تأكد من صحة الـ JSON، أقفل Claude Desktop كلياً، وافتحه من جديد.

  • Scanned PDF بيطلع فاضي

    الـ PDF عبارة صور بدون طبقة نص. شغّل OCR عليه أولاً، بعدين حوّله.

  • Python error على التثبيت

    نسختك تحت 3.10. حدّث Python وعاد التثبيت.

متى تستخدمه

وين بتفرق وبوين مش محتاج

أكبر فايدة vs تخطّاه

الحالةالقرارالسبب
PDFs طويلة، عروض، وجداول بياناتاستخدمه ✅هون بتشوف التوفير 70% بوضوح
YouTube، صفحات ويب، ZIPمفيد 👍بيسحبهم لنص نظيف Claude بيشتغل معه
ملفات نصية قصيرةتخطّاه ⏭️أصلاً رخيصة — ما بستاهل الخطوة

الملخص بنظرة

خارطة الطريق كاملة

كل شي بجدول واحد

#الخطوة
١افتح github.com/microsoft/markitdown واقرأ الـ README
٢ثبّت عبر pip install 'markitdown[all]'
٣حوّل أول ملف: markitdown document.pdf -o document.md
٤ثبّت MCP: pip install markitdown-mcp وضيفه للـ config
٥أعد تشغيل Claude Desktop وتحقق إن الأداة ظاهرة
٦ارفع ملفات .md بدل الـ PDF الخام

وفّرت توكنز كثيرة؟

تابعني للمزيد من الإعدادات

إذا هاد الدليل وفّرلك كومة من توكنز Claude، تابعني عشان توصلك إعدادات وأدوات جديدة زي هيك كل أسبوع.

تواصل معي على إنستغرامAbdallah

أبعتلك الدليل الجاي على الإيميل

إيميل واحد لكل فيديو جديد. بدون سبام، وبتقدر توقف بأي وقت.

هدايا ثانية