Щоб опублікувати документи як статичний сайт, попросіть AI‑агента конвертувати їх у Markdown з YAML‑метаданими та зображеннями, збереженими у файлах, а потім запустіть ваш генератор. GroupDocs.Markdown.Mcp виконує конвертацію локально, тому Claude Desktop, Claude Code, Cursor або GitHub Copilot можуть підготувати вміст Word, Excel та електронних книг для 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 у Hugo Markdown?

Hugo — це генератор, який використовується в цьому блозі, тому він слугує прикладом. Процес складається з чотирьох кроків, і агент виконує їх усі.

  1. Конвертувати. Запустіть наведений вище запит у папці з документами.
  2. Упорядкувати. Сервер записує файли; розташування — це завдання агента.

    Помістіть кожен конвертований файл у папку, названу за назвою документа, а його зображення — у підпапку images поруч із ним.

  3. Додати ключі, які вимагає тема. Теми Hugo часто очікують date або weight. Інструмент їх не записує, тому попросіть:

    Додайте weight у метадані кожного файлу, пронумеровані у порядку, в якому я їх навів.

  4. Зібрати. Запустіть Hugo самостійно. На цьому етапі файли — це звичайний Markdown з метаданими, і генератор обробляє їх як будь‑яку сторінку.

Для Docusaurus і MkDocs застосовується той самий результат; лише структура папок і додаткові ключі відрізняються, і ви описуєте їх у другому та третьому запитах.

Приклад сесії (скорочений)

You:   Convert the three documents in /drafts to Markdown with front matter, GitHub
       flavour, and images as files. One folder per document.
Agent: convert_to_markdown (frontMatter: true, flavor: "github", images: "file") x 3
       Created guide-onboarding/, guide-security/, price-list/ with .md files and
       images subfolders. Front matter holds title, author, format and page count.
You:   Add weight to each file in the order I listed them.
Agent: Updated the front matter of the three files with weight 10, 20 and 30.

Як перевірити результат перед публікацією?

Дві перевірки виявляють майже всі проблеми:

Для кожного конвертованого файлу порівняйте кількість сторінок у вихідному документі з довжиною Markdown.

Документ у 60 сторінок, який перетворився на 3 КБ Markdown, — це сканований PDF або запуск у режимі оцінки.

Перерахуйте папку зображень кожного документа та зображення, на які посилається його Markdown.

.md, який посилається на зображення, що не були записані, відображатиметься як пошкоджені зображення на сайті. Перевірте найгірший джерело перед пакетною обробкою двохсот документів.

Word і Excel джерела конвертуються зі збереженою структурою: заголовки залишаються заголовками, а таблиці — таблицями Markdown. PDF залежать від способу їх створення. Експорт у цифровому вигляді конвертується чисто; скан не конвертується у корисному сенсі, оскільки цей сервер не має кроку OCR.

Які ключі метаданих я додаю самостійно?

frontMatter: true записує назву, автора, формат і кількість сторінок. Перевірте ці значення у кожному файлі та попросіть агента виправити ті, що порожні або неправильні. Навігація, порядок, теги та дати — це ключі, які ви додаєте після конвертації, як у кроці 3. Щоб отримати більш багаті властивості документа у метаданих, поєднайте цей сервер з GroupDocs.Metadata.Mcp, який їх читає, і попросіть агента додати ключі; ця стаття цього не охоплює.

Чесні обмеження

Без ліцензії сервер працює в режимі оцінки, і обробляються лише перші 3 сторінки, кожна з оцінковим водяним знаком. Сайт, створений з неліцензованого виводу, містить тристорінкові заглушки довгих документів. Запустіть get_license_status перед конвертацією та залишайте перевірку «довжина проти джерела» у циклі.

FAQ

Як конвертувати Word у Hugo Markdown?

Попросіть агента конвертувати документ з frontMatter: true, images: "file" та flavor: "github", а потім упорядкувати файли у вашій папці контенту. Додайте будь‑які специфічні для теми ключі, наприклад weight, у другому запиті.

Чи може AI‑агент публікувати документи на статичний сайт?

Він може підготувати все, що потрібно для збірки сайту: Markdown, метадані, файли зображень та структуру папок. Ви запускаєте генератор, тому збірка та розгортання залишаються під вашим контролем.

Чи відбувається конвертація локально?

Так. GroupDocs.Markdown.Mcp працює як локальний процес через stdio і читає документи з папки, яку ви налаштували. Документи, які стають публічними лише після перегляду, залишаються на вашому комп’ютері, доки ви їх не опублікуєте.

Поглибити