Vibe Coding и DOM-docx: Как конвертировать HTML в редактируемые Word-документы без боли

Проблема: HTML в Word — это ад

Если вы когда-нибудь пробовали вставить HTML-разметку в Microsoft Word, вы знаете этот «особый» вид боли. Получается либо каша из стилей, либо документ, который невозможно редактировать без слёз. Я столкнулся с этим, когда мой клиент — небольшая юридическая фирма — попросил автоматизировать генерацию договоров. Исходные данные приходили в HTML, а финальный документ должен был быть в .docx с возможностью правок.

Перепробовал много подходов: от Pandoc до ручного копирования через буфер обмена. Pandoc давал статичный PDF-подобный вывод, а не редактируемый документ. Решение пришло неожиданно — через проект, который недавно засветился на Hacker News.

Show HN: DOM-docx — что это и как работает

DOM-docx — это open-source библиотека (MIT-лицензия), которая напрямую конвертирует HTML-разметку в нативный .docx с сохранением редактируемости. В отличие от многих аналогов, она не рендерит HTML как картинку, а создаёт настоящую DOM-подобную структуру внутри Word-документа: параграфы, списки, таблицы, заголовки — всё это можно будет потом менять вручную.

Автор проекта выложил его на GitHub под лицензией MIT, так что вы можете использовать его в коммерческих проектах без ограничений. Я протестировал библиотеку на нескольких реальных задачах — и результаты меня впечатлили.

Практический кейс: автоматизация договоров

Возьмём конкретный пример. У нас есть HTML-шаблон договора с переменными:

<h1>Договор № {number}</h1>
<p>Дата: {date}</p>
<p>Сторона 1: {party1}</p>
<p>Сторона 2: {party2}</p>
<table>
  <tr><th>Услуга</th><th>Стоимость</th></tr>
  <tr><td>{service}</td><td>{price}</td></tr>
</table>

Раньше я генерировал такой HTML на сервере, а потом мучительно конвертировал его в Word. С DOM-docx всё стало просто: я подключаю библиотеку через npm, передаю ей HTML-строку и получаю на выходе Buffer с .docx-файлом. Этот файл можно сразу отдать пользователю на скачивание.

Результат: Word-документ, в котором:
- Заголовки сохраняют стили (H1, H2)
- Таблицы остаются редактируемыми
- Списки (нумерованные и маркированные) работают корректно
- Можно менять шрифты, размеры, добавлять колонтитулы уже в Word

Технические детали для разработчиков

DOM-docx построен на принципе «сначала парсим HTML в DOM, потом маппим на Office Open XML». Это означает, что вы можете использовать любые стандартные HTML-теги: от и до

,
, . Поддерживаются вложенные структуры.

Библиотека не зависит от внешних сервисов — всё работает локально, что важно для соблюдения конфиденциальности данных (например, при обработке юридических документов).

Вот минимальный пример использования:

const domDocx = require('dom-docx');

const html = '<h1>Привет, мир</h1><p>Это <b>жирный</b> текст.</p>';
const buffer = await domDocx.convert(html);

// Сохраняем файл
fs.writeFileSync('output.docx', buffer);

На выходе — полноценный .docx, который можно открыть в Word, LibreOffice или Google Docs.

Сравнение с альтернативами

Инструмент	Редактируемый .docx	Сохранение стилей	Простота интеграции	Лицензия
DOM-docx	Да	Отлично	Просто (npm)	MIT
Pandoc	Частично	Средне	Средне (CLI)	GPL
LibreOffice	Да	Хорошо	Сложно (UNO API)	LGPL
html-docx-js	Да	Средне	Просто	MIT

DOM-docx выигрывает по сочетанию «простота + качество». В отличие от html-docx-js, он лучше справляется с таблицами и вложенными списками.

Где это реально нужно

Я вижу три основных сценария:

1. Генерация документов в CRM/ERP — когда нужно создать договор, счёт или акт в формате Word из шаблона.
2. Экспорт контента из CMS — редакторы хотят скачать статью в Word для дальнейшей правки.
3. Автоматизация отчётности — ежемесячные отчёты собираются из данных в HTML и превращаются в документы.

Во всех этих случаях DOM-docx экономит часы ручной работы.

Ограничения, о которых стоит знать

Библиотека ещё молодая, поэтому:
- Не поддерживает сложные CSS-селекторы (только inline-стили и базовые теги)
- Нет встроенной поддержки изображений (но их можно добавить через Base64)
- Не работает с JavaScript-генерируемым контентом (нужен статический HTML)

Тем не менее, для 90% типовых задач её возможностей хватает.

Вывод

DOM-docx — это тот случай, когда open-source проект решает реальную проблему просто и элегантно. Если вы занимаетесь автоматизацией документооборота или просто устали вставлять HTML в Word через буфер обмена — попробуйте эту библиотеку. Лично я уже включил её в свой стек для нескольких проектов.

Кстати, если вы хотите научиться интегрировать такие инструменты в свои бизнес-процессы, посмотрите на наши курсы по автоматизации — мы разбираем подобные кейсы от и до.

P.S. Репозиторий на GitHub активно развивается, так что подпишитесь на обновления — возможно, скоро появятся новые фичи, которых сейчас не хватает.