by geekjourneyx
Markdown to WeChat CLI | 一键排版发布到微信公众号:支持 40+ 排版样式和专业主题 、AI 配图 、批量发布
# Add to your Claude Code skills
git clone https://github.com/geekjourneyx/md2wechat-skillGuides for using ai agents skills like md2wechat-skill.
Last scanned: 4/27/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-27T06:27:59.745Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
30 days in the Featured rail · terms & refunds
面向 AI Agent 的公众号创作与发布 CLI
写 Markdown · 43 个高级排版模块 · 40 个专业主题 · AI 配图 · 推送草稿箱 全流程 CLI,Agent-native — Claude Code · Codex · OpenClaw 原生支持
快速开始 · 高级排版 · API 解锁 · Agent 支持 · 常见问题
市面上有很多 Markdown 排版工具,md2wechat 不一样的地方:
| 其他工具 | md2wechat | |
|---|---|---|
| 输出一致性 | LLM 每次不同 | API 模式确定性输出,同样 Markdown 永远相同 |
| 排版系统 | 靠 prompt 碰运气 | 43 个结构化排版模块(:::module 语法),API 专属 |
| 主题数量 | 无 / 寥寥几个 | 40 个专业主题,微信渲染精调 |
| 全流程 | 只做格式转换 | 写作 → 去 AI 痕 → 排版 → AI 配图 → 上传 → 推送草稿 |
| Agent 集成 | 无结构约定 | JSON envelope、capabilities 端点、discovery 命令 |
AI 模式(免费):生成排版 prompt,由你的 Claude / Codex 继续处理,3 个基础主题。
API 模式(专业服务):秒级响应,40 个专业主题,43 个高级排版模块,确定性输出,团队协作与自动化发布首选。
API 模式专属能力:
:::hero、:::callout、:::timeline… 结构化公众号内容设计语言,详见 高级排版指南申请 API 服务 / 加入微信交流群:
扫描下方二维码关注 极客杰尼 公众号 → 备注 「API咨询」 联系作者;或备注 「交流群」 申请加入用户交流群,和同类创作者一起探索 AI 驱动的公众号创作。
免费公开《杰尼AI实战手册》,我把过去一年做 md2wechat、AI Agent、内容工厂和知识库的实战经验放在这里。不会编程也能看,想写作、做项目、自动化发布,可以直接来这提问。
# macOS 优先推荐
brew install geekjourneyx/tap/md2wechat
其他安装方式(npm / go install / install.sh / Windows PowerShell)见 安装指南。
npm 全局安装也可以直接用:
npm install -g @geekjourneyx/md2wechat
md2wechat config init
# 打开生成的配置文件,填入微信公众号 AppID 和 Secret
AppID / Secret 获取方式与 IP 白名单配置详见 微信凭证指南。
# 确认文章解析结果(推荐第一步总是先 inspect)
md2wechat inspect article.md
# 本地预览 HTML(不触发上传或草稿副作用)
md2wechat preview article.md
# 转换并推送微信草稿箱
md2wechat convert article.md --draft --cover cover.jpg
如果你想把上面的步骤直接发给 Agent 执行,见 Agent 安装脚本。
| 命令 | 说明 |
|---|---|
inspect |
解析文章元数据与发布就绪状态;--json 在 data.readiness.targets/blockers 输出可执行目标状态 |
preview |
生成本地预览 HTML,不触发任何上传或草稿副作用 |
convert |
Markdown → 微信格式 HTML,可选 --draft 直接推送草稿 |
write |
风格写作,从一个想法生成完整文章 + 封面提示词 |
humanize |
AI 去痕,让 AI 生成的文章听起来像真人写的 |
generate_cover |
AI 生成封面图,内置专业 preset |
generate_infographic |
AI 生成信息图,内置 10+ 风格 preset |
upload_image |
上传图片到微信永久素材库 |
# 从一个想法到草稿箱,全流程 4 步
md2wechat write --style dan-koe # 1. 生成文章 + 封面提示词
md2wechat humanize article.md # 2. 去除 AI 痕迹
md2wechat generate_cover --article article.md # 3. AI 生成封面图
md2wechat convert article.md --draft --cover cover.jpg # 4. 推送草稿
在 Claude Code 中可以直接发自然语言:
"用 Dan Koe 风格写一篇关于 AI 时代独立开发者的文章,生成封面,推送到微信草稿箱"
仅 API 模式可用。 高级排版模块是 md2wechat 独有的能力 — 基于
:::module语法,提供 43 个结构化排版组件,是专为微信公众号设计的内容排版语言。不是 prompt,是一套确定性的设计系统。
:::module 语法示例在 Markdown 中用 ::: 包裹排版块:
:::hero
eyebrow: 深度观察
title: AI 时代的公众号写作
subtitle: 为什么你需要重新定义「好内容」
:::
:::callout
高级排版模块仅在 API 模式下生效。需要 API Key,扫码联系作者申请。
:::
:::timeline
- 2024:GPT-4 发布,内容生产门槛归零
- 2025:AI 写作工具爆发,同质化严重
- 2026:高质量、有视角的内容成为稀缺品
:::
同一篇 Markdown,包含一级标题、二级标题、引用、加粗、列表,以及 hero / cards / quote / summary / cta 等高级排版模块。
# 列出全部 43 个模块
md2wechat layout list --json
# 按用途筛选
md2wechat layout list --serves attention --json
md2wechat layout list --serves conversion --json
# 查看模块完整规格
md2wechat layout show hero --json
# 验证文章中的 :::module 用法
md2wechat layout validate --file article.md --json
layout list --json 和 layout show --json 会显示模块的 body_format:fields / rows / json_object / json_array。按这个字段写模块正文,example 只作参考。
保姆级教程(43 个模块全覆盖)见 docs/LAYOUT.md。
在 Coding Agent 或自动化脚本中,用 discovery 命令做事实来源,但按任务运行最小必要集合,不要把所有 catalog 都当成固定启动流程:
md2wechat themes list --json # 排版选主题时使用,按 selectable/type 判断能否用于当前模式
md2wechat layout list --json # 高级排版选模块时使用
md2wechat doctor --json # API、草稿、上传或配置本地可尝试性排障时使用
md2wechat prompts list --kind image --json # 图片 prompt 选择时使用
md2wechat providers list --json # 图片生成 provider 选择时使用
md2wechat capabilities --json # 版本、命令能力或行为边界不确定时使用
Agent 排版时应保持原始 Markdown 只读:把文章复制到临时 Markdown,按需用 layout render 插入少量模块,先 layout validate,再把临时稿交给 convert。只有用户明确要求时,才把生成稿保存到源文件旁边。
所有命令加 --json 后 stdout 只输出 JSON envelope,适合脚本和 Agent 直接消费。
| AI 模式(免费) | API 模式(专业) | |
|---|---|---|
| 是否需要 API Key | 不需要 | 需要(扫码联系作者申请) |
| 输出方式 | 生成 prompt,由外部 LLM 继续处理 HTML | 直接返回最终 HTML |
| 主题数量 | 3 个(autumn-warm / spring-fresh / ocean-calm) | 40 个专业主题 |
| 高级排版模块 | ❌ | ✅ 43 个 |
| 输出一致性 | 每次不同 | 确定性,同样输入同样输出 |
| 响应速度 | 取决于外部 LLM | 秒级 |
| 适合场景 | 实验、偶发写作 | 品牌内容、团队协作、自动化发布 |
# AI 模式(--mode ai,不需要 API Key)
md2wechat convert article.md --mode ai --theme autumn-warm --preview
# API 模式(默认,需要 API Key)
md2wechat convert article.md --preview
md2wechat 是 CLI-first 工具,天然适合集成进 Coding Agent。
# 安装 CLI(先装这个)
brew install geekjourneyx/tap/md2wechat
# 安装 skill(Claude Code / Codex / OpenCode)
npx skills add https://github.com/geekjourneyx/md2wechat-skill --skill md2wechat
安装后在 Claude Code 中直接用自然语言驱动:
"把 article.md 转换为微信格式,用 elegant-gold 主题,生成封面图,推送到草稿箱"
"帮我用 inspect --json 检查 data.readiness.targets/blockers,然后预览一下排版效果"
| 平台 | skill 路径 | 安装文档 |
|---|---|---|
| Claude Code / Codex / OpenCode | skills/md2wechat/ |
npx skills add ... |
| Obsidian(Claudian 插件) | ~/.claude/skills/ |
docs/OBSIDIAN.md |
| OpenClaw | platforms/openclaw/md2wechat/ |
docs/OPENCLAW.md |
OpenClaw 用户可以通过 ClawHub 直接安装:clawhub.ai/geekjourneyx/md2wechat
curl -fsSL https://github.com/geekjourneyx/md2wechat-skill/releases/download/v2.4.0/install-openclaw.sh | bash
支持多种 AI 图片生成服务,用于封面图、信息图和文章配图:
| 服务 | 推荐 | 说明 |
|---|---|---|
| Volcengine Ark | ⭐ 主推荐 | 豆包 Seedream 系列,高质量,国内直连 |
| ModelScope | 次推荐 | 有免费额度,国内访问稳定 |
| OpenRouter | 通用 | 多模型聚合,支持 Gemini / Flux |
| OpenAI | 通用 | 官方 GPT Image / DALL·E |
| Google Gemini | 通用 | 官方 Gemini 图片生成 |
配置方式详见 图片服务配置指南。
| 文档 | 说明 | |------