Чтобы перенести документацию в Markdown, передайте AI‑агенту папку архива и позвольте ему выполнить convert_to_markdown один раз для каждого файла, в проверенных партиях. С GroupDocs.Markdown.Mcp это происходит локально в Claude Code, Cursor, GitHub Copilot или другом клиенте MCP, поэтому архив внутренних процедур никогда не загружается в сервис конвертации:

Конвертировать всё в папке архива в Markdown с front matter и изображениями как отдельными файлами. Сообщить исходный формат, количество страниц и размер вывода для каждого.

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

Почему миграция устаревшей документации — задача для агента?

Конвертация механична, а сопутствующая работа повторяется: перечислить файлы, конвертировать каждый, измерить результат, найти ошибки, повторить. Человек, выполняющий это для сотен файлов, принимает одно и то же решение сотни раз. Агент делает это последовательно и сообщает каждый результат, в то время как движок, а не модель, генерирует Markdown. Сохранённый Markdown не является пересказом ваших процедур.

Это руководство (runbook). Каждый шаг имеет один запрос, а таблица после него разделяет то, что решает агент, и то, что делает движок.

Руководство: как перенести архив Word в Markdown?

  1. Проверьте лицензию перед всем остальным.

    Перед конвертацией: каков статус лицензии markdown‑сервера?

    get_license_status возвращает mode, licensed, consumption и версии сервера и движка. Режим оценки обрабатывает 3 страницы на документ, поэтому нелицензированный запуск выдаёт правдоподобные заглушки.

  2. Инвентаризация архива.

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

    У markdown‑сервера нет инструмента листинга папок, поэтому агент перечисляет папку с помощью собственного доступа к файлам клиента или работает с именами файлов, которые вы ему предоставляете.

    Затем get_document_info возвращает fileFormat, pageCount, title, author и isEncrypted для каждого файла без конвертации. Для зашифрованных файлов нужен параметр password.

  3. Запустите пилотный набор из примерно двадцати файлов.

    Конвертировать первые двадцать документов в Markdown с front matter и изображениями как отдельными файлами. Сообщить формат, количество страниц и размер вывода для каждого.

  4. Найдите, что не конвертировалось.

    Перечислите PDF‑файлы, конвертация которых дала менее 2 KB Markdown при более чем 5 страницах.

    Это почти всегда сканы. На этом сервере нет шага OCR, поэтому им нужен другой инструмент или они остаются PDF, проиндексированными метаданными.

  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, который ссылается на картинки, которые никогда не были записаны, будет отображать битые изображения. Затем откройте самый «мутный» исходный файл и его вывод рядом, прежде чем применять шаблон к остальному. Зафиксируйте проверенный результат обычным git‑рабочим процессом; сервер пишет файлы и не трогает ваш репозиторий.

Пример сеанса (сокращённый)

Вы:   Конвертировать первые двадцать документов в /archive в Markdown с front matter
       и изображениями как отдельными файлами. Сообщить формат, страницы и размер вывода для каждого.
Агент: 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
       Девятнадцать файлов выглядят согласованно; один скан требует отдельной обработки.

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

Без лицензии режим оценки обрабатывает только первые 3 страницы каждого документа, накладывая на каждый оценочный водяной знак. Запуск миграции в таком состоянии даёт сотни коротких файлов, которые выглядят правильно, а пробел обнаруживается через недели, когда кто‑то ищет процедуру, которой нет. Для миграции нужна лицензия, поэтому выполните get_license_status перед первой партией. Сканированные PDF не конвертируются.

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

Могу ли я конвертировать сотни Word‑документов в Markdown одновременно?

Да, но не в одном запросе. Конвертируйте партиями по около двадцати файлов и читайте отчёт после каждой, чтобы исправить неверный параметр до применения к всему архиву.

Как перенести документацию в git с помощью AI‑агента?

Сервер записывает файлы .md и изображения в папку вывода. Вы проверяете их и фиксируете в обычном git‑рабочем процессе.

Загружает ли миграция docs‑as‑code мои документы?

Нет. GroupDocs.Markdown.Mcp — локальный процесс, архив читается с диска. Только то, что агент пишет в разговоре, попадает к поставщику модели.

Подробнее