ls-open/md-to-word

Инструмент командной строки, который собирает .docx из Markdown, применяя стили из отдельного файла format.txt. Нужен тем, кто готовит документы с фиксированными требованиями к вёрстке и хочет держать исходники и правила в системе контроля версий.

Ключевые возможности

• Формат задаётся в файле format.txt, который можно версионировать вместе с исходником.
• Повторная сборка из одного исходника даёт побайтово идентичный .docx.
• Проверяет полноту формата и корректность имён стилей до экспорта, указывая строку с ошибкой.
• Поддерживает академические и официальные стили: шрифты, отступы, таблицы, формулы, ссылки.
• Два способа использования: CLI и навык для AI-агента (Agent Skill).
• В комплекте примеры с готовыми настройками для разных типов документов.

Для каких задач подходит

• Подготовка диссертаций и статей для журналов с требованиями к оформлению.
• Создание технических отчётов и документации по стандартам.
• Оформление официальных документов и инструкций с единым стилем.
• Автоматизация сборки документов в CI/CD для проверки соответствия формату.
• Использование в связке с AI-агентом для генерации документов по Markdown-исходнику.

Подробнее

md-to-word — утилита на Python, которая превращает Markdown в Word не через шаблоны и ручную правку, а через компиляцию с явными правилами. Правила оформления вынесены в текстовый файл format.txt, где каждая строка описывает стиль для элемента документа: шрифт, размер, отступы, выравнивание, параметры таблиц. Этот файл лежит рядом с исходником и попадает в Git, что делает оформление воспроизводимым и проверяемым. При сборке инструмент сверяет исходник с форматом и останавливается с указанием строки, если что-то не задано или имя стиля написано неверно. В отличие от решений, которые вставляют Markdown в предварительно созданный шаблон Word, здесь документ генерируется с нуля на основе OOXML, что обеспечивает побайтовую идентичность при повторных запусках. Это важно для научных публикаций и отчётов, где требуется стабильность и соответствие строгим требованиям. Инструмент имеет два интерфейса: командную строку и навык для AI-агента (Agent Skill), что позволяет использовать его как в ручном режиме, так и в автоматизированных пайплайнах. Стоит учесть, что для работы требуется Python 3.10+ и установка пакета md-to-word-docx (команда называется md-to-word).