md2wechat

md2wechat 是一款专为微信公众号设计的 Markdown 转 HTML 排版及全流程创作 CLI 工具，由开发者 geekjourneyx 创建，GitHub 2.1k+ Stars。其定位是“AI 时代的公众号创作工作台”，覆盖从写作、去 AI 痕迹、排版、AI 配图到推送草稿箱的完整流程。工具采用 Go 1.26+ 实现，提供 40+ 专业主题（Minimal / Focus / Elegant / Bold 四大系列）和 43 个结构化 :::block 高级排版模块。架构上分为 AI 模式（免费，生成 prompt 由 LLM 执行，输出不确定）和 API 模式（专业服务，确定性输出，需付费）。md2wechat 为 Agent 集成设计了完整的发现协议，原生兼容 Claude Code、Codex、OpenClaw。许可证为 BUSL-1.1，个人/学习/非商用免费，商用需授权，2030-01-01 后自动转为 Apache 2.0。

md2wechat 针对公众号创作者面临的六大痛点：微信编辑器不支持 Markdown，手动排版耗时（一篇可能花 1-2 小时）；用 AI 生成排版 prompt 输出不稳定，无法形成统一风格；写作、排版、配图、上传工具割裂，切换效率低；市面工具主题少，无法匹配不同内容气质；手动操作无法接入 CI/CD 或 Agent 工作流；公众号缺少 hero 区、callout、timeline、数据卡等结构化排版组件。md2wechat 将链路优化为“Markdown 写作 → 确定性排版 → 自动上传草稿箱”，自动化中间重复性劳动。

md2wechat 的核心是 Go 实现的 Markdown → 微信内联样式 HTML 转换引擎。工作流程包括：解析 Markdown 及 frontmatter；处理 :::block 自定义排版指令；根据选中主题注入颜色、字体、间距等样式；生成微信内联样式 HTML（微信不支持 <style> 标签，必须内联）；自动上传图片到微信永久素材库并替换为 CDN URL；输出 HTML 或通过微信 API 推送草稿箱。架构上采用双模式：AI 模式（免费，生成 prompt 由 LLM 执行，3 个基础主题，无高级模块，输出不确定）和 API 模式（专业服务，调用后端 API 确定性转换，40+ 主题和 43 个高级模块，秒级响应）。同时设计了 Agent 协议层，提供 capabilities、themes list、layout list、layout validate 等 JSON 端点，支持 Claude Code、Codex、OpenClaw 原生集成。

• 确定性输出：API 模式下同样输入永远得到同样结果
• 全流程覆盖：写作→去痕→排版→配图→推送一条龙
• 个 :::block 结构化排版模块（hero、callout、timeline、comparison 等）
• • 专业主题，四大系列（Minimal / Focus / Elegant / Bold）
• 内置 humanizer 去 AI 痕迹引擎，支持 gentle/medium/aggressive/authentic 四级强度
• Agent-native 设计：JSON envelope + capabilities + discovery 协议
• 风格写作系统：内置 Dan Koe 等风格，支持自定义 YAML
• 多平台安装：brew / npm / go install / install.sh / Windows PowerShell
• 微信官方 API 集成：草稿箱、素材库、图片上传全部官方接口

• AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
• • 仅支持微信公众号平台，不支持头条、知乎等其他内容平台
• 高级排版模块（:::block）和 40+ 主题仅 API 模式可用，AI 模式（免费）只有 3 个基础主题
• API 模式需要付费，且依赖 md2wechat 后端服务可用性
• 许可证为 BUSL-1.1，个人/学习/非商用免费，商业使用需联系作者授权，2030-01-01 后自动转为 Apache 2.0
• 从源码编译需要 Go 环境
• API 模式需要联网，AI 模式也需要 LLM 可用
• 微信 AppID/Secret 不应硬编码，建议使用环境变量或配置文件
• 图片上传走微信官方 API，数据不经过第三方