md2wechat本文保留 2.0.0 发布时的功能范围，并补充当前入口。当前稳定转换接口统一以 POST https://www.md2wechat.cn/api/convert 为准；当前 CLI 版本以 npm、GitHub Release 和本机 md2wechat version --json 为准。
md2wechat 用于把 Markdown 转为微信公众号 HTML，并可通过主 CLI 与 Agent Skill 继续处理预览、标题建议、图片计划和草稿创建。
适合处理哪些任务
- 将已有 Markdown 转成微信可用 HTML。
- 在发布前预览主题、高级排版和图片效果。
- 在 Agent 中调用固定命令完成转换和校验。
- 配置微信凭证后上传图片并创建公众号草稿。
- 在不同写作入口中复用同一套发布步骤。
产品入口
网站与接口
- md2wechat.cn：中文主站，提供在线编辑器、文档与当前稳定 API。
- md2wechat.com：国际站，提供国际文档与独立 Publishing API。
- md2wechat.app：中文主站镜像与备用入口。
POST https://www.md2wechat.cn/api/convert：Markdown 转微信公众号 HTML。https://md2wechat.com/api/v1：国际站 Publishing API 基础地址。
命令行与 Agent
- @geekjourneyx/md2wechat：主 CLI，命令为
md2wechat。 - md2wechat-skill：供 Claude Code、Codex 等 Agent 使用的操作说明。
- md2wechat-lite：独立轻量工具，不是主 CLI 的别名。
- obsidian-md2wechat：Obsidian 集成。
API 模式与 AI 模式
| 模式 | 适合任务 | 依赖 |
|---|---|---|
| API 模式 | 把确定的 Markdown 稳定转换为 HTML | md2wechat API Key |
| AI 模式 | 写作、改写和风格调整 | 可用的模型环境 |
已有成稿时，先用 API 模式转换和预览。需要 Agent 参与写作或改写时，再使用 AI 模式。两种模式可以前后组合，但不应混淆认证方式。
常用工作流
已有 Markdown 文章
md2wechat convert article.md --preview
- 预览 HTML。
- 选择主题并检查高级模块。
- 确认图片、链接和行动区。
- 需要时创建草稿。
只有选题或提纲
md2wechat write --idea "写一篇关于 AI Agent 发布工作流的文章"
先生成并人工检查正文，再进入转换流程。若需要调整模型生成痕迹，可以使用：
md2wechat humanize article.md
创建公众号草稿
md2wechat convert article.md --draft --cover cover.jpg
创建草稿需要微信公众号 AppID、AppSecret、IP 白名单和封面图。/api/convert 本身不需要微信凭证。
Agent 接入前先查询能力
不要猜主题名、Provider、Prompt、模块字段或枚举值。先运行发现命令：
md2wechat capabilities --json
md2wechat providers list --json
md2wechat themes list --json
md2wechat prompts list --json
高级排版语法还应按手册查询字段并运行校验。兼容旧输入不代表 Agent 可以继续生成旧写法。
发布前检查
- API 模式已经配置 md2wechat API Key。
- 当前主题名来自 discovery，而不是手写猜测。
- HTML 已在手机尺寸预览。
- 图片可以访问，封面比例正确。
- 创建草稿时已配置微信凭证和 IP 白名单。
下一步可阅读：