Markdown转微信公众号

解决什么问题

把 Markdown 草稿塞进公众号后台，通常意味着手动粘贴、重设样式、上传图片和反复预览。md2wechat 让 agent 直接操作 CLI，把排版、封面、草稿创建等步骤收敛到可检查的命令里，避免在编辑器里反复返工。

核心能力与流程

• 标准文章转换：先用 md2wechat inspect --json 查看元数据与就绪状态；需要本地确认时运行 md2wechat preview；正式转换用 md2wechat convert。
• 发布目标区分：convert --draft 面向文章草稿；多图帖、图文笔记应使用 create_image_post，不能当作 convert --draft 的别名。
• 主题与版式：API 模式可使用高级布局模块，AI 模式（--mode ai）不解析 :::module 语法。选择主题前应通过 discovery 读取 type 与 selectable，不要凭记忆猜测。
• 图片与封面：可用 generate_cover 或 generate_infographic；未配置图像 provider 时，使用 image plan 模式（--plan --json）输出提示意图，再交给宿主图像工具。
• 写作辅助：title suggest --json 只生成标题提示请求；humanize 用于去 AI 痕迹；doctor --json 只做本地配置就绪检查。

边界与注意点

• inspect --json 中的 data.readiness.targets 与 data.readiness.blockers 是发布前的判定依据。
• API 转换需要 md2wechat API credentials；创建微信草稿需要微信凭证，且必须有封面参数。
• 图片只有在 --upload 或 --draft 时才会上传或替换，普通转换和 preview 不会触发。
• AI 请求或风格写作可能返回提示请求而非最终文本；配置不确定时先运行 discovery，不要猜测。