MarkItDown: למה כדאי להפסיק להעלות PDF ל-Claude כמו שהוא

בקצרה: כשגוררים PDF ל-Claude, הוא קורא כל עמוד גם כטקסט וגם כתמונה. לפי התיעוד של Anthropic זה 1,500 עד 3,000 טוקנים של טקסט לעמוד, ועוד העלות של התמונה. MarkItDown, כלי קוד פתוח של מיקרוסופט, ממיר את הקובץ ל-Markdown נקי לפני כן. הוא חינמי, מקבל כמעט כל סוג קובץ, ויש לו שרת MCP. הוא לא מתאים למסמכים שהעיקר בהם הוא מה שרואים בעין.

גם אני עושה את זה. חוזה, מצגת של לקוח, דוח של 30 עמודים: גורר לחלון של Claude ושואל. זה עובד, אז לא חשבתי פעמיים.

ואז ראיתי ריל של Roman Knox שנפתח במשפט "תפסיקו לגרור PDF ל-Claude". הלכתי לבדוק את הטענות שלו מול התיעוד של Anthropic ומול הריפו של הכלי. חלק מהן מדויקות, חלק צריכות תיקון קטן. הנה מה שמצאתי.

למה PDF עולה ל-Claude כל כך הרבה?

PDF הוא לא מסמך טקסט. הוא קובץ שנועד להיראות טוב בהדפסה: עימוד, גופנים, טבלאות שנשברות בין עמודים, תמונות, כותרות עליונות שחוזרות בכל דף.

לפי התיעוד של Anthropic, Claude מעבד כל עמוד בשתי דרכים: הוא מחלץ את הטקסט, וגם הופך את העמוד לתמונה ומסתכל עליה. הטקסט לבד עולה 1,500 עד 3,000 טוקנים לעמוד, לפי כמה הוא צפוף. התמונה מתומחרת בנפרד, כמו כל תמונה אחרת.

במסמך של 20 עמודים זה מצטבר מהר. וכל מה שנכנס תופס מקום בחלון הזיכרון של השיחה (context window), עוד לפני שכתבתם שאלה אחת.

מה זה MarkItDown?

MarkItDown הוא ספריית Python של מיקרוסופט, בקוד פתוח וברישיון MIT. כשבדקתי היום היו לריפו כ-192.5 אלף כוכבים ב-GitHub, כלומר הרבה מאוד אנשים כבר משתמשים בו.

הוא עושה דבר אחד: לוקח קובץ ומוציא ממנו טקסט Markdown. כותרות נשארות כותרות, רשימות נשארות רשימות, טבלאות הופכות לטבלאות טקסט. העיצוב, הגופנים והקישוטים נשארים בחוץ.

אילו קבצים הוא מקבל?

• מסמכים: PDF, וורד, אקסל, פאוורפוינט, HTML, CSV, JSON, XML ו-EPub.
• מדיה: תמונות (כולל זיהוי טקסט), אודיו (עם תמלול) וקישורים ליוטיוב.
• ארכיונים: קובצי ZIP, שהוא עובר על התוכן שלהם.

למה Markdown עדיף בשביל Claude?

שתי סיבות. הראשונה היא כמות: טקסט נקי בלי תמונה של כל עמוד תופס פחות מקום. יוצר הריל מדבר על עד 70% פחות טוקנים. זה המספר שלו ולא בדקתי אותו, והוא תלוי מאוד במסמך. דוח עמוס עיצוב ירוויח הרבה, מסמך טקסט פשוט פחות.

הסיבה השנייה היא איכות. מודלי שפה רואים Markdown כל הזמן, והמבנה שלו ברור להם: מה כותרת, מה סעיף, מה שורה בטבלה. כשהשיחה לא עמוסה בזבל של עימוד, יש יותר מקום לשאלה שלכם ולתשובה.

רוצים כל שבוע את הכלים שבאמת חוסכים זמן בעבודה עם AI? אני כותב ניוזלטר שבועי, "אלעד עמרני AI", עם מה שבדקתי, מה עבד ומה לא. להרשמה לניוזלטר

איך מתחילים לעבוד איתו?

צריך Python בגרסה 3.10 עד 3.14. ההתקנה בשורה אחת, לפי הריפו:

1. מתקינים בטרמינל: pip install 'markitdown[all]'
2. ממירים קובץ: markitdown report.pdf -o report.md
3. מעלים ל-Claude את קובץ ה-md במקום את ה-PDF.

אם אתם עובדים ב-Claude Code, אפשר פשוט לבקש ממנו להריץ את ההמרה על תיקייה שלמה ולעבוד מול קבצי ה-md.

ומה עם שרת ה-MCP?

פה הריל קצת מגזים. לפי הריפו, החבילה markitdown-mcp נותנת ל-Claude כלי אחד בשם convert_to_markdown, שמקבל נתיב לקובץ או קישור ומחזיר Markdown. Claude מפעיל אותו כשהוא צריך לקרוא קובץ. זה לא מנגנון שתופס כל קובץ שאתם גוררים לחלון וממיר אותו מאחורי הקלעים.

עדיין, זה נוח: מחברים פעם אחת ל-Claude Desktop, ומשם אפשר לכתוב "תקרא את הקובץ הזה בתיקייה" בלי להמיר ידנית.

⚠️ שני דברים שהריפו מדגיש: השרת מיועד לשימוש מקומי בלבד, ואין בו הזדהות. הוא יכול לקרוא כל קובץ שהמשתמש שמריץ אותו יכול לקרוא. לא פותחים אותו לרשת.

מתי לא כדאי להמיר?

• גרפים ותרשימים. ההמרה לטקסט מאבדת את מה שרואים. אם השאלה שלכם היא על הגרף, תנו ל-Claude את ה-PDF.
• סריקות. PDF שהוא בעצם תמונה של דף צריך זיהוי טקסט, והתוצאה לא תמיד נקייה.
• עיצוב שהוא חלק מהתוכן. טופס, חשבונית או מצגת שבה המיקום על הדף אומר משהו.

מה אני הייתי עושה

הייתי לוקח את ה-PDF הכי כבד שאתם שולחים ל-Claude באופן קבוע, ממיר אותו פעם אחת עם MarkItDown, ושואל את אותה שאלה פעמיים: פעם על ה-PDF ופעם על ה-md. ככה תדעו על הקבצים שלכם, ולא לפי ריל, כמה זה חוסך ואם התשובה נשארת טובה. אם כן, תהפכו את זה להרגל.

שאלות נפוצות

מה זה MarkItDown?

כלי קוד פתוח של מיקרוסופט, ברישיון MIT, שממיר קבצים לטקסט Markdown. הוא מקבל PDF, וורד, אקסל, פאוורפוינט, HTML, CSV, קובצי ZIP, תמונות, אודיו וקישורים ליוטיוב.

כמה טוקנים זה חוסך?

תלוי במסמך. לפי Anthropic עמוד PDF עולה 1,500 עד 3,000 טוקנים של טקסט, ועוד העלות של התמונה. יוצר הריל מדבר על עד 70% פחות, וכדאי למדוד על הקבצים שלכם.

שרת ה-MCP ממיר כל קובץ שאני מעלה לבד?

לא בדיוק. הוא נותן ל-Claude כלי המרה ש-Claude מפעיל כשצריך. הוא מיועד לשימוש מקומי בלבד, ואין בו הזדהות.

מתי עדיף להעלות את ה-PDF עצמו?

כשהמסמך מלא בגרפים, סריקות או עיצוב שחשוב להבנה. ההמרה לטקסט מאבדת את מה שרואים בעין.

אם זה חסך לכם קצת טוקנים, הצטרפו לניוזלטר "אלעד עמרני AI". כל שבוע אני שולח את הכלים והטריקים שבדקתי בעבודה עם AI. ואם אתם רוצים סוכני AI בתוך החברה שלכם, אני גם מפתח סוכנים לחברות ב-Agentic-dev ומעביר סדנאות לצוותים.

קרדיט: הרעיון למאמר הגיע מריל של Roman Knox באינסטגרם. העובדות נבדקו מול הריפו של MarkItDown ומול התיעוד של Anthropic.