md2wechat

核心功能

md2wechat 是一款专为微信公众号内容生产者设计的命令行工具，打通 Markdown 到微信生态的完整工作流：

内容转换：将 Markdown 转换为微信官方支持的 HTML 格式，提供 api（本地渲染）和 ai（智能排版）两种模式，内置多套视觉主题（如 autumn-warm）。

智能预览：inspect 命令解析文章元数据并评估发布风险；preview 生成本地独立 HTML 文件供预览，不依赖微信接口。

视觉生成：支持封面图（cover）、信息图（infographic）的 AI 生成，内置预设模板（如 cover-hero、infographic-comparison），可按文章元数据自动适配尺寸比例。

草稿管理：一键上传图文草稿，自动处理图片上传、元数据映射（标题≤32字、作者≤16字、摘要≤128字），支持纯图片消息（image post）。

创作者工具：模仿特定创作者风格写作（如 dan-koe）、去除 AI 写作痕迹（humanize），支持多档强度调整。

显著优点

• 工作流闭环：覆盖写作、排版、配图、预览、发布的完整链路，减少工具切换
• 微信原生兼容：严格遵循微信图文规范，规避常见审核风险
• 配置灵活：支持 YAML/JSON/环境变量多级配置，适配本地与 CI/CD 场景
• 预设丰富：主题、提示词、配图模板均支持实时发现，避免硬编码依赖

局限性与风险

• 外部依赖：AI 模式需配置 API 密钥（如 OpenRouter），图像生成依赖额外服务
• 环境变量要求：草稿上传必须配置 WECHAT_APPID 和 WECHAT_SECRET
• 错误代码需人工判断：如 45004 错误需区分摘要过长与正文过长
• AI 生成非确定性：--mode ai 和风格写作可能返回待完成的 prompt 而非终稿

适用人群

微信公众号运营者、技术写作者、内容团队，尤其适合习惯 Markdown 写作、需要批量处理图文发布的技术背景用户。

常规风险

• 敏感内容需人工复核后再执行 --draft 或 --upload
• 远程图片下载、外部 AI 服务调用存在网络超时与隐私泄露风险
• 微信接口配额限制可能导致批量操作失败