Публикуем статьи из Markdown в WeChat без ручной верстки
Если вам когда-нибудь приходилось публиковать статьи в WeChat Official Accounts, вы наверняка помните этот специфический опыт. Встроенный веб-редактор платформы парсит стили странно, стандартный Markdown туда нормально не вставишь, а верстка таблиц или врезок с кодом быстро превращается в ручную расстановку inline-стилей.
Для тех, кто пишет документацию или технические статьи в Markdown и одновременно ведет каналы на китайскую аудиторию, китайский разработчик geekjourneyx выкатил утилиту md2wechat. Это CLI-инструмент на Go, заточенный под автоматизацию верстки и интеграцию с AI-агентами вроде Claude Code.
Зачем нужен отдельный инструмент
WeChat не понимает обычный Markdown. Ему нужен специфический HTML со строгим набором встроенных стилей, иначе на экранах смартфонов текст превратится в кашу. Большинство существующих конвертеров работают через браузерные расширения: вставил текст, нажал кнопку, скопировал форматированный кусок в буфер обмена.
Для одиночной заметки раз в месяц такого подхода хватает. Но если вы настраиваете CI/CD для документации или поручаете генерацию и публикацию черновиков агентам, браузерный буфер обмена становится узким местом.
md2wechat решает задачу в терминале. Утилита берет локальный .md файл, валидирует разметку, подтягивает стили, генерирует обложку и через официальный API WeChat отправляет готовый пост прямо в черновики аккаунта.
Как устроен рабочий процесс
Инструмент спроектирован по принципу разделения проверок и действий с сайд-эффектами. Вы не отправляете сырой файл сразу в API платформы. Сначала запускается инспекция:
npm install -g @geekjourneyx/md2wechat
md2wechat config init --json
md2wechat inspect article.md --json
Команда inspect возвращает метаданные, проверяет пути к картинкам, заголовки и сообщает статус готовности к публикации (draft readiness).
После этого генерируется локальный HTML для проверки:
md2wechat preview article.md --output preview.html
Если результат устраивает, одной командой создается черновик в нужном аккаунте:
md2wechat convert article.md --draft --cover cover.jpg
Команда загрузит картинки в медиахранилище WeChat, привяжет обложку и сформирует черновик статьи. При этом веб-интерфейс открывать вообще не нужно.
Архитектура для AI-агентов
Самая любопытная часть проекта кроется в его ориентации на автономных агентов (Claude Code, OpenClaw, WorkBuddy). Разработчик выстроил интерфейс так, чтобы LLM могли вызывать CLI без риска сломать окружение или запутаться в текстовом выводе.
Практически у каждой команды есть флаг --json. Вывод форматируется в виде компактного однострочного JSON-объекта, который агент сразу парсит в структуру данных.
md2wechat capabilities --json
md2wechat doctor --json
md2wechat themes list --json
md2wechat layout list --json
Команда capabilities отдает агенту список доступных действий в текущей системе, а doctor проверяет конфигурацию токенов и IP-вайтлистов WeChat. Если у агента нет прав на загрузку картинок или токен просрочен, он узнает об этом до выполнения боевых запросов.
Расширенный Markdown и верстка
Обычные статьи в WeChat требуют визуальных акцентов: врезок, плашек с цитатами, карточек продуктов. В стандартном Markdown таких элементов нет. Авторы проекта добавили поддержку синтаксиса контейнеров :::module:
:::hero
eyebrow: Обзор репозитория
title: Автоматизация публикаций
subtitle: Как подружить Markdown и WeChat
:::
:::callout
Этот блок отрендерится в стилизованную плашку с акцентной рамкой.
:::
Локальная команда md2wechat layout validate --file article.md --json проверяет синтаксис кастомных блоков перед рендерингом. Всего поддерживается более 50 типов структурных элементов.
Генерация обложек и работа с графикой
Помимо текста, утилита умеет готовить иллюстрации через API популярных нейросетей (OpenAI, Gemini, OpenRouter, Volcengine).
Вы можете запросить генерацию обложки по содержанию статьи:
md2wechat generate_cover --article article.md --preset cover-semantic-concept
Либо перевести команду в режим планирования --plan --json. В этом режиме утилита не делает прямых запросов к генераторам изображений, а формирует готовый промпт и параметры картинки для внешнего агента, который сам решает, какой инструмент для рисования вызвать.
Нюансы лицензирования и использования
Репозиторий использует лицензию Source Available. Для личных проектов, экспериментов и изучения код открыт и доступен бесплатно. Но если вы планируете встраивать утилиту в коммерческий SaaS, использовать для клиентских услуг или делать ребрендинг, потребуется коммерческая лицензия у автора.
Часть расширенных тем оформления и удаленный рендерер привязаны к API-сервису разработчика, хотя базовый функционал конвертации и работа с локальными LLM доступны сразу после установки.
Кому пригодится
Проект узкоспециализированный, но в своей нише закрывает огромную головную боль. Если вы продвигаете опенсорс-продукт на азиатский рынок, пишете корпоративные блоги для китайских партнеров или строите пайплайны контент-маркетинга на базе AI, md2wechat-skill избавит от часов ручного форматирования в браузере. Инструмент стоит попробовать хотя бы ради того, чтобы посмотреть, как аккуратно можно спроектировать CLI-интерфейс для совместной работы человека и AI-агента.
