2026/09/05
Markdown 到公众号草稿箱的完整流水线
从 inspect 到 draft/add 的五个阶段、为什么草稿必须显式给封面，以及 45004 怎么排查。
Markdown 到公众号草稿箱的完整流水线
草稿链路有五个阶段，前两个不碰网络。完整参考。
五个阶段
md2wechat inspect article.md --json——元数据（title ≤ 32 字符、author ≤ 16、digest ≤ 128）、图片盘点，以及带 blockers 的readiness.targets（如MISSING_COVER、MISSING_WECHAT_CONFIG）。- Preflight——任何远程调用前校验意图、素材与封面。
- Convert——经 Convert API（
POST https://www.md2wechat.cn/api/convert）渲染 HTML。 - Upload——
--upload把文章图片转成微信素材并重写 URL；--cover上传封面并得到media_id。 - Draft——微信
draft/add返回draft_id与draft_url。
每篇草稿都要显式封面
md2wechat convert article.md --draft --cover cover.jpg--cover <path> 与 --cover-media-id <media_id> 互斥；inspect 对 CONFLICTING_COVER_INPUTS、COVER_MEDIA_ID_INVALID、MISSING_COVER fail-closed。细节见封面图。
45004 排查
微信错误 45004 表示 digest 不合法——先查摘要长度（上限 128 字符）。重试前先清 readiness blockers；--save-draft 只保存草稿 JSON 不提交，create_draft <json> 之后提交；test-draft <html> <cover> 是最小冒烟路径。
安全边界
草稿创建是副作用：需要用户明确意图、有效凭证，以及平台要求时的白名单出口（微信 IP 白名单）。
更多文章
邮件列表
加入我们的社区
订阅邮件列表，及时获取最新消息和更新