Word to Markdown

Word to Markdown — MCP-сервер сообщества (автор — benbalter). Конвертация документов Word (.docx) в Markdown. Ставится через npx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
benbalter
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Читает .docx по переданному пути и может записывать Markdown и изображения; без overwrite не перезаписывает файлы и не пишет через символические ссылки.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"word-to-markdown\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"word-to-markdown\", \"mcp\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README для любого клиента с JSON-конфигом",
    "verified": "docs"
}

Что умеет

Word to Markdown — конвертер документов Word (DOCX) в Markdown, который работает из командной строки, как библиотека Node.js, в браузере на word2md.com и как MCP-сервер. Это полностью переписанная, более быстрая и надёжная версия оригинального проекта word-to-markdown.

Что переносится в Markdown:

  • абзацы, разрывы строк и заголовки (уровни берутся из стилей абзацев Word, а не из размера шрифта);
  • полужирный, курсив и зачёркнутый текст, верхние и нижние индексы;
  • маркированные, нумерованные и вложенные списки, таблицы и ссылки;
  • сноски и концевые сноски — в формате сносок GFM/Pandoc;
  • изображения — встроенными в base64 или извлечёнными в отдельные файлы;
  • формулы Office Math — в LaTeX: строчные $…$ или отдельные блоки $$.

Подчёркивание, комментарии и колонтитулы по умолчанию отбрасываются, а при отбрасывании содержательных элементов конвертер предупреждает.

MCP-сервер (w2m mcp) работает локально через stdio и даёт один инструмент — convert_docx_to_markdown. Агент передаёт путь к файлу .docx, а сервер читает и конвертирует его на вашем компьютере. Параметры: output_path — записать Markdown в файл вместо возврата в ответе (удобно для длинных документов), image_dir — извлечь изображения в папку, overwrite — разрешить перезапись, а также bullet_lists и preserve_footnotes. Результат возвращается вместе с предупреждениями о документе.

Кому подойдёт

  • Тем, кто переносит документацию из Word в репозитории, вики или генераторы сайтов на Markdown.
  • Тем, кто даёт агенту документы Word для анализа: Markdown занимает меньше контекста и лучше читается моделью.

Похожие серверы — в категории файлы и документы.

Установка

Нужен Node.js. Утилиту можно запускать через npx без установки или поставить глобально — тогда появится команда w2m:

npm install -g word-to-markdown

Для Claude Desktop есть готовое расширение word-to-markdown.mcpb: его достаточно скачать со страницы релизов и открыть двойным щелчком, Node.js и терминал не нужны.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add word-to-markdown -- npx -y word-to-markdown mcp

README приводит этот JSON для любого MCP-клиента с конфигом в формате JSON, в том числе Cursor.

Проверка

Попросите агента конвертировать конкретный файл .docx по абсолютному пути и показать первые абзацы результата. Для проверки без агента выполните npx word-to-markdown input.docx > output.md.

Примеры задач

Конвертируй ~/Documents/report.docx в Markdown и сохрани рядом как report.md, изображения извлеки в папку images.
Прочитай договор contract.docx и кратко перечисли обязательства сторон.

Риски

  • Чтение и запись файлов. Сервер читает любые файлы .docx по переданному пути и может записывать Markdown и изображения. По умолчанию он отказывается перезаписывать существующие файлы и не пишет через символические ссылки — это важно, если агент действует по указаниям, прочитанным в самом документе.
  • Содержимое документов. Текст документа попадает в контекст агента и к сервису модели, которым вы пользуетесь. Сам конвертер ничего никуда не отправляет.
  • Предупреждения. Зашифрованные документы и метки конфиденциальности сопровождаются предупреждениями — проверяйте их перед использованием результата.

Частые вопросы

Загружаются ли документы на сервер?

Нет. И MCP-сервер, и веб-версия обрабатывают документы локально; на word2md.com используется только анонимная аналитика Cloudflare.

Почему в результате нет картинок?

В режиме MCP изображения по умолчанию отбрасываются, чтобы base64 не переполнял контекст агента. Укажите image_dir, чтобы извлечь их в файлы.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

browser-use

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники