md2wechat：一个 Go 语言写的 CLI 工具，把 Markdown 直接转换成微信公众号排版并上传草稿箱。GitHub 2100+ Star，40+ 主题、43 个排版模块。

核心结论

指标	数据
GitHub Stars	2100+
语言	Go
主题数	40+
排版模块	43 个
AI 助手支持	Claude Code / Codex / OpenClaw

解决什么问题

如果你运营公众号，应该经历过这种场景：

• 在微信编辑器里排两小时版，换个手机预览全崩
• 用 Typora / Obsidian 写稿，但发布时得把 Markdown 复制到编辑器里一点点调样式

md2wechat 就是解决这个痛点的。

你继续用 Markdown 写作，它负责把 Markdown 转成带排版的公众号文章，然后直接上传到你的微信草稿箱。全程命令行，不需要打开浏览器。

适合人群

适合	不适合
长期运营公众号的创作者	只在手机上写作
技术团队的内容运营	对排版没有要求
用 AI 辅助写稿但被排版困扰的人	不习惯用命令行

安装方法

macOS（推荐 Homebrew）

brew install geekjourneyx/tap/md2wechat

npm

npm install -g md2wechat

Go install

go install github.com/recallwei/md2wechat@latest

install.sh

curl -fsSL https://raw.githubusercontent.com/recallwei/md2wechat/main/install.sh | bash

基本工作流

┌─────────────────────────────────────────────────────────────┐
│                    md2wechat 工作流                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   1. 用 Markdown 写文章                                    │
│      └── favorite.md                                       │
│              ↓                                             │
│   2. 运行 md2wechat 转换                                    │
│      └── md2wechat convert favorite.md                     │
│              ↓                                             │
│   3. 排版自动生成（40+主题可选）                            │
│              ↓                                             │
│   4. 上传到微信草稿箱                                       │
│      └── md2wechat upload favorite.md                      │
│              ↓                                             │
│   5. 登录公众号后台发布                                     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

整个过程在终端完成，不需要打开公众号后台编辑器。

md2wechat vs 其他工具

工具	排版方式	批量发布	AI 集成	上传方式
md2wechat	43 个模块	✅ 支持	✅ Claude/Codex/OpenClaw	直接上传草稿箱
微信编辑器	手动排版	❌	❌	手动复制
其他转换工具	每次 AI 随机	❌	部分支持	复制代码

关键差异：确定性排版

md2wechat 在 API 模式下：同样的 Markdown 永远输出同样的排版。

这和其他工具不同——不是每次让 AI 重新生成。对需要批量发布、团队协作的场景很关键。

43 个排版模块

项目提供了 43 个结构化排版模块，通过 :::block 语法在 Markdown 里直接调用。

常用模块

模块	语法	效果
英雄区	:::block hero	大标题 + 副标题 + 封面图
引用块	:::block callout	醒目的引用样式
时间线	:::block timeline	时间线展示
步骤	:::block steps	步骤列表
表格	:::block table	美化表格
对比	:::block compare	左右对比

使用示例

:::block hero
# 文章标题
副标题描述
:::

:::block callout
重要提示：这里是醒目的引用内容
:::

:::block steps
1. 第一步：安装 md2wechat
2. 第二步：编写 Markdown
3. 第三步：上传到草稿箱
:::

40+ 主题

主题分为四个系列：

系列	风格	适用场景
Minimal	简约干净	科技、技术文档
Focus	突出重点	教程、指南
Elegant	优雅精致	生活方式、美学
Bold	醒目大胆	新闻、热点

可以在官网预览效果再决定用哪个。

指定主题

# 使用特定主题
md2wechat convert article.md --theme elegant

# 列出所有主题
md2wechat list-themes

免费够用吗

项目分两种模式：

模式	限制	适合场景
免费模式	基础功能	个人使用、尝鲜
API 模式	解锁完整能力	团队协作、批量发布

免费模式够用，API 模式解锁完整能力。

AI 助手集成

支持接入 Claude Code / Codex / OpenClaw 等 AI 助手：

# 配置 AI 助手
md2wechat config set ai.provider claude
md2wechat config set ai.api-key YOUR_KEY

# AI 辅助写作 + 自动排版
md2wechat convert draft.md --ai-assist

实际使用场景

场景一：AI 辅助写稿

你：用 Claude Code 写一篇文章草稿
Claude Code：生成 Markdown 格式的文章
你：md2wechat convert article.md --theme focus
系统：自动排版 + 上传草稿箱

场景二：团队协作

作者：用 Markdown 写稿（保持一致风格）
编辑：md2wechat convert article.md --theme minimal
系统：确定性排版，团队统一风格
发布：上传草稿箱，审核发布

场景三：批量发布

# 批量转换
for file in articles/*.md; do
  md2wechat convert "$file" --theme elegant
done

# 批量上传
md2wechat upload --dir articles/ --draft

一句话总结

md2wechat = 用 Markdown 写公众号，命令行搞定排版和发布。

核心优势：

• 40+ 主题 / 43 个排版模块
• 确定性排版（同样内容同样效果）
• AI 助手集成
• 直接上传草稿箱

适合人群：技术创作者、AI 辅助写稿者、需要批量发布的团队。