Md2wechat Skill

md2wechat

面向 AI Agent 的微信公众号创作与发布 CLI

写 Markdown，生成公众号排版，制作封面和文章配图，预览校验后推送草稿箱。

支持 Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent、OpenClaw 等 Agent 通过 JSON discovery 稳定调用。

排版效果 · 快速开始 · 专业 API · 联系我 / 获取 API Key · 文档

接入有疑问？关注公众号「极客杰尼」，发消息「API咨询」；也可以直接发邮件到 skrphper@gmail.com。查看联系方式与二维码

[!TIP] v3.8.0 高级排版升级：83 个推荐场景对应 59 个推荐语法；新增 cover-reveal、expand，gallery 进入推荐目录，并扩展 12 种品牌图形符号与动效。 新互动模块默认完整静态展示；显式 first-layer 仅为点击候选，微信内效果仍待验证。布局指南 · 版本化安装

---

这个项目解决什么问题

md2wechat 把公众号发布流程拆成一组可验证的 CLI 命令：

场景	md2wechat 提供
Markdown 转微信 HTML	convert，支持预览、上传图片、创建草稿
发布前检查	inspect --json 输出标题、摘要、图片、cover、draft readiness
稳定排版	API 模式成功时返回最终 HTML，覆盖 83 个主推高级排版场景条目和 59 个主推 ::: 语法名
Agent 自动化	capabilities、doctor、themes、layout、providers 等 discovery 命令
内容生产	write、humanize、title suggest、generate_cover、generate_infographic
定向产品写作（v3.7.0）	组合目标搜索产品、文章平台、体裁与作者语气，也可准备分平台百科词条草稿；使用说明
多平台草稿	本地准备正文，宿主复用已登录浏览器，按内置步骤写入知乎、CSDN、头条、腾讯云开发者社区草稿
多账号发布	命名公众号账号，本地只读发现，不输出 Secret
微信白名单	高级 API 服务可提供微信接口固定出口能力

---

排版效果

先看文章排出来的样子，再选择使用方式。

图中内容为排版示例；专业主题与高级模块的服务范围见专业 API。

查看更多主题与模块样稿

查看完整主题与样稿 · 高级排版教程

---

快速开始

npm install -g @geekjourneyx/md2wechat@3.8.0
md2wechat version --json
md2wechat config init --json
md2wechat config validate --json

以下预览和转换命令使用付费 API 模式，需要先配置 md2wechat API Key。联系我获取 Key · 查看服务范围与价格。完成凭证配置后，先检查文章，再把 HTML 明确写入本地文件：

md2wechat inspect article.md --json
md2wechat preview article.md --output preview.html
md2wechat convert article.md --output article.html

以上命令不会上传图片或创建草稿。需要创建微信草稿时，先按同一目标检查，再显式执行副作用：

md2wechat inspect article.md --draft --cover cover.jpg --json
md2wechat convert article.md --draft --cover cover.jpg

如果使用可选的 --wechat-account，必须在 inspect 和 convert 两条命令中传入同一个账号名。

想先了解免费 AI 模式？它会生成交给宿主 Agent / 外部 LLM 继续处理的 prompt，不会直接返回最终 HTML。见 AI 模式使用步骤。

v3.6.0 新增跨平台草稿流程：先准备正文，再由宿主 Agent 按内置步骤操作已登录的浏览器。已安装版本先用 capabilities --json 确认支持：

md2wechat sync prepare article.md --output ./article-prepared --json
md2wechat skills read md2wechat references/sync/workflow.md --json

准备结果是等待宿主执行，不代表草稿已创建。平台步骤、图片处理、头条标题限制和恢复方式见 多平台草稿。

安装方式、微信凭证和 IP 白名单配置见：

• 安装指南
• 微信凭证与 IP 白名单指南
• 配置保姆级指南

---

专业 API

API 模式适合需要稳定输出、多人协作、批量发布或 Agent 自动化的场景。

专业 API 是付费服务，包含稳定转换接口、定期更新和专属创作交流群。服务范围与价格以官网及开通时确认的信息为准。

查看服务范围与价格 · 联系我 / 获取 API Key · 接口文档

能力	免费 AI 模式	专业 API 模式
输出方式	生成 prompt，由外部 LLM 继续处理	直接返回微信 HTML
主题	3 个基础主题	48 个专业主题
高级排版模块	不解析，:::module 作为普通段落输出	API renderer 解析 59 个推荐 :::module 语法
转换结果	需要外部 LLM 完成 HTML	converter 成功时返回最终 HTML
发布自动化	适合实验	适合团队、客户号、矩阵号

专业能力包括：