כדי לפרסם מסמכים כאתר סטטי, בקש מסוכן AI להמיר אותם ל‑Markdown עם חומר ראשי ב‑YAML ותמונות שמורות כקבצים, ואז הפעל את המחולל שלך. GroupDocs.Markdown.Mcp מבצע את ההמרה באופן מקומי, ולכן Claude Desktop, Claude Code, Cursor או GitHub Copilot יכולים להכין תוכן מ‑Word, Excel ו‑e‑book עבור Hugo, Jekyll, MkDocs או Docusaurus מבלי לשלוח אותו לשירות:

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

הגרסה הצעד‑אחר‑צעד עם תצורה ופתרון בעיות נמצאת בתיעוד: How to publish documents to a static site as Markdown.

מה מחולל אתר סטטי צריך ממסמך?

שלושה דברים: Markdown לגוף, חומר ראשי ב‑YAML למטא‑דטה, ותמונות כקבצים בנתיבים יחסיים. Hugo, Jekyll, MkDocs ו‑Docusaurus כולם קוראים חומר ראשי. convert_to_markdown מייצר את שלושת המרכיבים כאשר אתה בוחר באפשרויות עבורו:

אפשרות ערך עבור אתר מה היא עושה
frontMatter true כותב YAML עם כותרת, מחבר, פורמט וספירת עמודים בראש הקובץ
images "file" כותב תמונות לצד קובץ ה‑.md ומפנה אליהן בנתיב יחסי
flavor "github" (ברירת מחדל), או "commonmark" Markdown בפורמט GitHub הוא מה שרוב המחוללים מניחים; CommonMark מתאים לצינור כלים מחמיר יותר

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

איך אני ממיר Word ל‑Markdown של Hugo?

Hugo הוא המחולל שמאחורי הבלוג הזה, ולכן הוא הדוגמה כאן. התהליך כולל ארבעה שלבים, והסוכן מריץ את כולם.

  1. Convert. הפעל את הפקודה שלמעלה בתיקיית המסמכים.
  2. Arrange. השרת כותב קבצים; סידור הקבצים הוא משימת הסוכן.

    שים כל קובץ מומר בתיקייה בשם המסמך, עם התמונות בתת‑תיקייה images לצידו.

  3. Add the keys the theme wants. ערכות נושא של Hugo לעיתים מצפות ל‑date או weight. הכלי אינו כותב אותם, ולכן בקש:

    הוסף weight לחומר הראשי של כל קובץ, ממוספר לפי הסדר שרשמתי.

  4. Build. הפעל את Hugo בעצמך. בשלב זה הקבצים הם Markdown רגיל עם חומר ראשי, והמחולל מתייחס אליהם כמו לכל עמוד.

ל‑Docusaurus ול‑MkDocs הפלט זהה; רק מבנה התיקיות והמפתחות הנוספים שונים, ואתה מתאר אותם בפקודות השנייה והשלישית.

דוגמת שיחה (מקוצרת)

אתה:   המר את שלושת המסמכים ב‑/drafts ל‑Markdown עם חומר ראשי, פורמט GitHub, ותמונות כקבצים. תיקייה אחת לכל מסמך.
סוכן: convert_to_markdown (frontMatter: true, flavor: "github", images: "file") x 3
       נוצרו guide-onboarding/, guide-security/, price-list/ עם קבצי .md ותת‑תיקיות images. החומר הראשי כולל כותרת, מחבר, פורמט וספירת עמודים.
אתה:   הוסף weight לכל קובץ לפי הסדר שרשמתי.
סוכן: עדכן את החומר הראשי של שלושת הקבצים עם weight 10, 20 ו‑30.

איך אני בודק את התוצאה לפני הפרסום?

שתי בדיקות תופסות כמעט כל בעיה:

עבור כל קובץ מומר, השווה את ספירת העמודים של המקור עם האורך של ה‑Markdown.

מסמך של 60 עמודים שהפך ל‑3 ק״ב של Markdown הוא PDF סרוק או ריצה במצב הערכה.

רשום את תיקיית התמונות של כל מסמך ואת התמונות שה‑Markdown שלו מפנה אליהן.

.md שמפנה לתמונות שמעולם לא נכתבו מציג תמונות שבורות באתר. ערוך בדיקה מהירה של המקור המורכב ביותר לפני אצווה של מאתיים.

מקורות Word ו‑Excel מומרות עם המבנה שלהם שלם: כותרות הופכות לכותרות וטבלאות הופכות לטבלאות Markdown. PDFs תלויים באופן יצירתם. ייצוא דיגיטלי נולד מומר בצורה נקייה; סריקה אינה מתורגמת באופן משמעותי, מכיוון שהשרת הזה אינו כולל שלב OCR.

אילו מפתחות של חומר ראשי אני מוסיף בעצמי?

frontMatter: true כותב כותרת, מחבר, פורמט וספירת עמודים. בדוק ערכים אלה בכל קובץ ובקש מהסוכן לתקן כל ערך ריק או שגוי. ניווט, סדר, תגים ותאריכים הם מפתחות שאתה מוסיף לאחר ההמרה, כפי שבשלב 3. כדי למשוך תכונות מסמך עשירות יותר לחומר הראשי, חבר שרת זה עם GroupDocs.Metadata.Mcp, אשר קורא אותן, ותן לסוכן להוסיף את המפתחות; פוסט זה אינו מכסה זאת.

מגבלות כנות

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

שאלות נפוצות

איך אני ממיר Word ל‑Markdown של Hugo?

בקש מהסוכן להמיר את המסמך עם frontMatter: true, images: "file" ו‑flavor: "github", ואז לסדר את הקבצים בתיקיית התוכן שלך. הוסף כל מפתח ספציפי לנושא, כגון weight, בפקודה שנייה.

האם סוכן AI יכול לפרסם מסמכים לאתר סטטי?

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

האם ההמרה מתבצעת מקומית?

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

להעמיק