用途:md2wechat 用于将 Markdown 转换为微信公众号文章 HTML,并支持文章元数据检查、本地预览、草稿上传与图片类内容创建。需要先确认发布目标:普通文章走 convert / inspect / preview;小绿书、图文笔记、图片消息、newspic、多图帖子走 create_image_post,两者发布目标不同,不可互换。
主要能力:转换与预览(inspect、preview、convert);图片处理(upload_image、download_and_upload、generate_image、generate_cover、generate_infographic);草稿与图文消息(create_draft、test-draft、create_image_post);写作与去 AI 痕迹(write、humanize)。元数据解析顺序为标题 --title→frontmatter.title→首个 Markdown 标题→“未命名文章”;作者取 --author 或 frontmatter.author;摘要取 --digest→frontmatter.digest→summary→description。限制:标题 32 字、作者 16 字、摘要 128 字。创建草稿必须提供 --cover 或 --cover-media-id。
使用方式:先做发现,再选资源,例如 md2wechat version --json、md2wechat capabilities --json、md2wechat providers list --json、md2wechat themes list --json、md2wechat prompts list --json,并用 show 子命令检查具体资源。常用转换:md2wechat inspect article.md、md2wechat preview article.md、md2wechat convert article.md -o output.html、md2wechat convert article.md --draft --cover cover.jpg。配置检查顺序:~/.config/md2wechat/config.yaml、环境变量(如 MD2WECHAT_BASE_URL)、项目内 md2wechat.yaml/.yml/.json。转换默认 api 模式,除非指定 --mode ai。
适用场景:公众号文章排版与草稿准备、封面与信息图生成、图片帖发布、按创作者风格写作或降低 AI 写作痕迹。
限制与注意事项:草稿上传和发布操作需要 WECHAT_APPID 与 WECHAT_SECRET,图片生成可能需要在 config.yaml 中额外配置提供方;远程图片仅在明确要求时下载,外部图像生成服务需已配置;仅当用户明确要求时才执行草稿创建、发布或远程图片生成。inspect 是元数据与就绪状态的可信来源;preview 输出独立本地 HTML 预览,不上传或写回;convert --preview 与独立 preview 命令不同;预览中的 --mode ai 仅为降级确认,不等同最终 AI 排版。价格、平台范围等资料未提供。