Чтобы публиковать документы как статический сайт, попросите AI‑агента конвертировать их в Markdown с YAML‑front‑matter и изображениями, сохранёнными в виде файлов, а затем запустите ваш генератор. GroupDocs.Markdown.Mcp выполняет конвертацию локально, поэтому Claude Desktop, Claude Code, Cursor или GitHub Copilot могут подготовить контент Word, Excel и электронных книг для Hugo, Jekyll, MkDocs или Docusaurus без отправки его в сервис:

Преобразуйте эти документы в Markdown с front matter, вариантом GitHub и изображениями, сохранёнными в виде файлов.

Пошаговая версия с настройками и устранением неполадок находится в документации: Как публиковать документы как статический сайт в формате Markdown.

Что требуется генератору статического сайта от документа?

Три вещи: Markdown для содержимого, YAML front matter для метаданных и изображения в виде файлов по относительным путям. Hugo, Jekyll, MkDocs и Docusaurus все читают front matter. convert_to_markdown создаёт всё это, когда вы выбираете соответствующие параметры:

Опция Значение для сайта Что делает
frontMatter true Записывает YAML с заголовком, автором, форматом и количеством страниц в начале файла
images "file" Записывает изображения рядом с файлом .md и ссылается на них по относительному пути
flavor "github" (default), or "commonmark" Markdown в стиле GitHub — то, что предполагают большинство генераторов; CommonMark подходит для более строгой цепочки инструментов

Проверьте заголовок и автора в начале каждого конвертированного файла; если они пусты или неверны, попросите агента установить их.

Как конвертировать Word в Hugo Markdown?

Hugo — генератор, используемый в этом блоге, поэтому он служит примером. Процесс состоит из четырёх шагов, и агент выполняет их все.

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

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

  3. Добавьте ключи, требуемые темой. Темы Hugo часто ожидают date или weight. Инструмент их не записывает, поэтому попросите:

    Добавьте weight в front matter каждого файла, пронумеровав их в порядке, в котором я их перечислил.

  4. Собрать. Запустите Hugo самостоятельно. На данном этапе файлы представляют собой обычный Markdown с front matter, и генератор обрабатывает их как любую страницу.

Для 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.

Какие ключи front matter я добавляю вручную?

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

Честные ограничения

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

Часто задаваемые вопросы

Как конвертировать Word в Hugo Markdown?

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

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

Он может подготовить всё, что необходимо для сборки сайта: Markdown, front matter, файлы изображений и структуру папок. Вы запускаете генератор, поэтому сборка и развертывание остаются под вашим контролем.

Происходит ли конвертация локально?

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

Углубиться