/ الدليل / الملعب / markdownify-mcp
← كل الخوادم ↗ GitHub
● مجتمع zcaceres ⚡ فوري

markdownify-mcp

بواسطة zcaceres · zcaceres/markdownify-mcp

تحويل ملفات PDF ومستندات Word والجداول والعروض التقديمية والصفحات الويب والصور والملفات الصوتية وفيديوهات YouTube إلى صيغة markdown نظيفة مباشرة من الدردشة.

zcaceres/markdownify-mcp هي أداة MCP مكتوبة بـ TypeScript توفر واجهة موحدة لأدوات التحويل (تتضمن markitdown من Microsoft وأداة لجلب نصوص فيديوهات YouTube). خيار ممتاز لتغذية خطوط أنابيب RAG ولإدراج الوثائق القديمة في سير عمل يعتمد على markdown بشكل أساسي.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

markdownify.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "markdownify",
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "markdownify": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "markdownify-mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add markdownify -- npx -y markdownify-mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: markdownify-mcp

كيفية استيراد مجلد من ملفات PDF إلى قاعدة معرفة markdown

👤 منشئو أنظمة RAG ومديرو المعرفة ⏱ ~30 min intermediate

متى تستخدمه: عندما تملك 50 ورقة بحثية بصيغة PDF وتريد نصًا نظيفًا لتضمينه

المتطلبات الأساسية
  • pnpm — npm i -g pnpm
  • التثبيت والتشغيل — git clone the repo, pnpm install, pnpm start
الخطوات
  1. عدّد الملفات
    اعدد كل ملفات .pdf الموجودة في /library/papers/.✓ تم النسخ
    → قائمة بالمسارات
  2. تحويل دفعي
    لكل ملف، استدعِ pdf-to-markdown. اكتب الناتج في /library/markdown/<same-name>.md.✓ تم النسخ
    → ظهور ملفات markdown
  3. تحقق من واحد
    أظهر لي أول 500 حرف من /library/markdown/attention-is-all-you-need.md.✓ تم النسخ
    → markdown مقروء بدون آثار PDF

النتيجة: شجرة /markdown/ متوازية جاهزة للتضمين

المزالق
  • ملفات PDF الممسوحة ضوئيًا (التي تحتوي على صور فقط) تنتج markdown فارغة — قم بمعالجة OCR لملفات PDF الممسوحة ضوئيًا قبل التحويل
  • ملفات PDF التي تحتوي على الكثير من الرموز الرياضية تفقد المعادلات — بخصوص الرياضيات، جرب الدمج مع Mathpix أو نموذج nougat OCR بشكل منفصل
اجمعها مع: filesystem

كيفية تحويل تسجيل الاجتماع إلى ملاحظات قابلة للبحث

👤 أي شخص يسجل الاجتماعات ⏱ ~10 min beginner

متى تستخدمه: بعد الاجتماع مباشرة، قبل أن تتلاشى الذاكرة

المتطلبات الأساسية
  • مفتاح OpenAI الخاص بـ Whisper — platform.openai.com (or any Whisper-compatible endpoint)
الخطوات
  1. انسخ صوتيًا
    استخدم audio-to-markdown على /recordings/2026-04-14-standup.m4a.✓ تم النسخ
    → markdown مع الطوابع الزمنية
  2. استخرج الإجراءات
    من النص المنسوخ، أعد قائمة بعناصر الإجراء مع المسؤولين✓ تم النسخ
    → قائمة تحقق من الإجراءات

النتيجة: ملاحظات اجتماع قابلة للبحث + إجراءات

المزالق
  • Whisper قد يسيء تسمية المتحدثين — للفصل بين المتحدثين، استخدم أداة متخصصة؛ markdownify توفر لك النص فقط
اجمعها مع: notion

كيفية تلخيص فيديو YouTube دون مشاهدته

👤 الباحثون والمتعلمون ⏱ ~5 min beginner

متى تستخدمه: عندما يكون لديك فيديو مدته 90 دقيقة وأنت تملك 5 دقائق فقط

الخطوات
  1. احصل على النص المكتوب
    استخدم youtube-to-markdown https://youtu.be/xyz123.✓ تم النسخ
    → نص markdown للفيديو
  2. لخص
    لخص في 5 نقاط + الطوابع الزمنية المهمة✓ تم النسخ
    → ملخص نقطي مع نقاط القفز

النتيجة: قرار بشأن ما إذا كان يجب مشاهدة الفيديو فعلاً

المزالق
  • بعض الفيديوهات قد تكون الترجمات معطلة فيها — الأداة ستعيد قيمة فارغة — استخدم audio-to-markdown بدلاً من ذلك إذا كان لديك الملف

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

markdownify + filesystem

تحويل دفعي لمجلد البريد الوارد إلى مجلد قاعدة المعرفة

حول كل ملف في /inbox/ إلى markdown تحت /kb/ مع الحفاظ على هيكل المجلدات✓ تم النسخ
markdownify + notion

أسقط المستندات المحولة مباشرة في Notion

حول ملف PDF /specs/rfq-2026.pdf وأنشئ صفحة Notion بالنتيجة✓ تم النسخ
markdownify + excel

ادمج xlsx-to-markdown مع excel MCP للتحويل ذهابًا وإيابًا

اقرأ ورقة 'Summary' من /report.xlsx، وحول إلى markdown، واحفظ في /docs/report.md✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
pdf-to-markdown path_or_url: str لتحويل ملفات PDF free (local)
docx-to-markdown path_or_url: str مستندات Word free
xlsx-to-markdown path_or_url: str الجداول الإلكترونية كجداول free
pptx-to-markdown path_or_url: str العروض التقديمية free
image-to-markdown path_or_url: str الصور free or 1 LLM call if OCR enabled
audio-to-markdown path: str الملفات الصوتية/ملاحظات صوتية 1 Whisper call ($0.006/min)
youtube-to-markdown url: str ترجمات YouTube free
webpage-to-markdown url: str نصوص الويب المقروءة free
bing-search-to-markdown query: str بحث ويب سريع free
get-markdown-file path: str استرجع تحويل سابق free

التكلفة والحدود

تكلفة التشغيل

حصة API
لا توجد حصص للمحولات المحلية؛ Whisper/OpenAI للملفات الصوتية
الرموز لكل استدعاء
يعتمد على حجم المستند
التكلفة المالية
مجاني ما عدا نسخ الملفات الصوتية (~$0.006/دقيقة عبر Whisper)
نصيحة
لمجموعات PDF كبيرة، قم بالتحويل قبل لصقها في نموذج اللغة — أرخص من طلب Claude لتحليل ملفات PDF مباشرة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: قراءة نظام الملفات للملفات المصدرية، الكتابة في الناتج
تخزين بيانات الاعتماد: OPENAI_API_KEY (للملفات الصوتية) في المتغيرات البيئية
نقل البيانات الخارجي: المحولات المحلية تبقى محلية. الملفات الصوتية تذهب إلى خادم Whisper الخاص بك
لا تمنح أبدًا: لا تمرر روابط غير موثوقة عبر webpage-to-markdown بدون تحديد — خطر SSRF

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

pnpm install fails

إصدار Node قديم جدًا — يتطلب Node 18+. استخدم nvm install 20.

تحقق: node -v
pdf-to-markdown returns empty string

على الأرجح ملف PDF ممسوح ضوئيًا (صور فقط). قم بمعالجة OCR أولاً (ocrmypdf).

youtube-to-markdown 'no captions available'

مالك الفيديو عطل الترجمات. حمل الملف الصوتي واستخدم audio-to-markdown بدلاً من ذلك

audio-to-markdown 401

OPENAI_API_KEY مفقود أو غير صحيح

تحقق: echo $OPENAI_API_KEY

البدائل

markdownify-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
markitdown (Microsoft)عندما تريد المحول الأساسي مباشرة بدون MCPلا توجد واجهة MCP؛ يتطلب التغليف الخاص بك
unstructured.ioالاستيراد على مستوى المؤسسة مع الوعي بالتخطيطالميزات المتقدمة مدفوعة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills