כדי להעביר תיעוד ל‑Markdown, תן לסוכן AI את תיקיית הארכיון ותן לו להריץ convert_to_markdown פעם אחת לכל קובץ, במנות שנבדקו. עם GroupDocs.Markdown.Mcp זה קורה מקומית ב‑Claude Code, Cursor, GitHub Copilot או לקוח MCP אחר, ולכן ארכיון של נהלים פנימיים לעולם לא מועלה לשירות המרה:

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

הגרסה הצעד‑אחר‑צעד עם תצורה ופתרון בעיות נמצאת בתיעוד: איך להעביר תיעוד ישן ל‑Markdown עם AI.

למה העברת תיעוד ישן היא משימה עבור סוכן?

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

זהו מדריך ריצה. לכל שלב יש פקודה אחת, והטבלה שמאחר כך מפרידה בין מה שהסוכן מחליט לבין מה שה‑engine עושה.

מדריך ריצה: איך להעביר ארכיון Word ל‑Markdown?

  1. בדוק את הרישיון לפני כל דבר אחר.

    לפני המרה של כל דבר: מהו מצב הרישיון של שרת ה‑markdown?

    get_license_status מחזיר mode, licensed, consumption ואת גרסאות ה‑server וה‑engine. מצב הערכה מעבד 3 עמודים לכל מסמך, ולכן ריצה ללא רישיון מייצרת תבניות סבירות.

  2. בצע אינבנטורי של הארכיון.

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

    לשרת ה‑Markdown אין כלי לרשימת תיקיות, ולכן הסוכן רושם את התיקייה באמצעות גישה לקבצים של ה‑client שלו או עובד משמות הקבצים שאתה מספק.

    לאחר מכן get_document_info מחזיר fileFormat, pageCount, title, author ו‑isEncrypted עבור כל קובץ ללא המרה. קבצים מוצפנים דורשים את הפרמטר password.

  3. הפעל פיילוט של כ‑עשרים קבצים.

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

  4. מצא מה שלא הומר.

    רשום את קבצי ה‑PDF שההמרה שלהם ייצרה פחות מ‑2 KB של Markdown עבור יותר מ‑5 עמודים.

    אלה כמעט תמיד סריקות. אין שלב OCR בשרת זה, ולכן הם זקוקים לכלי אחר או נשארים כ‑PDFים המתועדים על ידי metadata.

  5. תקן את התבנית, ואז הרץ את השאר במנות. עשרים קבצים לכל סבב, עם דוח בכל פעם, משאיר את הריצה ניתנת לביקורת ושומר על שימוש מדוד צפוי.

  6. סקור את הפלט כפי שהיית עושה עם pull request. הקטעים הבאים מפרטים מה לבדוק.

החלטה סוכן מנוע
אילו קבצים להמיר, באיזה סדר ובאיזו גודל של מנות כן לא
אילו אפשרויות להעביר (images, frontMatter, flavor) כן, מההנחיה שלך לא
המרת כותרות, רשימות וטבלאות ל‑Markdown לא כן
שמירת קבצי .md ותמונות לא כן
זיהוי קובץ של 300 עמודים שהפך ל‑4 KB כן, מהדוח לא
שינוי שם, מבנה תיקיות, מפתחות front-matter נוספים כן לא

אילו פורמטים עוברים היטב?

  • DOCX, DOC, RTF, ODT. המבנה ברור במקור, ולכן כותרות וטבלאות מועברות בצורה נקייה.
  • EPUB ו‑MOBI. מבנה הפרקים ממופה על כותרות Markdown.
  • CHM. קבצי עזרה ישנים, לעיתים העתק היחיד של נהלים.
  • XLSX. גיליונות עבודה הופכים לטבלאות, המתאימות לרשימות פרמטרים.

מה צריך לבדוק בביקורת?

בקש מהסוכן לבצע את הסריקה הראשונה, ואז קרא מדגם בעצמך:

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

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

תמונות שנכתבות עם images: "file" יושבות לצד קובץ ה‑.md ומופנות באמצעות נתיב יחסי, שזה מה שמאגר תיעוד מצפה לו. .md שמפנה לתמונות שמעולם לא נכתבו מציג תמונות שבורות. לאחר מכן פתח את המקור המורכב ביותר ואת הפלט שלו זה לצד זה לפני שאתה מיישם את התבנית על השאר. בצע commit לתוצאה שנבדקה עם זרימת העבודה הרגילה של git; ה‑server כותב קבצים ואינו נוגע במאגר שלך.

דוגמת סשן (מקוצרת)

You:   Convert the first twenty documents in /archive to Markdown with front matter
       and images as files. Report format, pages and output size for each.
Agent: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 pages   converted
       install-guide.chm      CHM    41 pages   converted
       supplier-forms-2009.pdf PDF   12 pages   1 KB of Markdown: probably a scan
       Nineteen files look consistent; one scan needs separate handling.

מגבלות כנות

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

שאלות נפוצות

האם אני יכול להמיר מאות מסמכי Word ל‑Markdown בבת אחת?

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

איך אני מעביר תיעוד ל‑git עם סוכן AI?

השרת כותב קבצי .md וקבצי תמונה לתיקיית הפלט. אתה סוקר אותם ומבצע commit עם זרימת העבודה הרגילה של git.

האם העברת docs-as-code מעלה את המסמכים שלי?

לא. GroupDocs.Markdown.Mcp הוא תהליך מקומי, והארכיון נקרא מהדיסק. רק מה שהסוכן כותב בשיחה מגיע לספק המודל.

צלול לעומק