md2wechat

核心用法

md2wechat 是一款面向内容创作者和运营团队的 Markdown 转微信公众号 HTML 专业工具，提供从写作到发布的完整工作流。核心命令族包括：

• 内容转换：convert 将 Markdown 转为微信 HTML，默认 API 模式支持高级布局模块；--mode ai 为轻量替代方案
• 本地预览：preview 生成本地预览文件，inspect --json 检查文章元数据与发布就绪状态
• 图片发布：create_image_post 处理多图笔记/图片首条，generate_cover/generate_infographic 生成封面与信息图
• AI 辅助：write 按创作者风格续写，humanize 去除 AI 痕迹，title suggest 生成标题候选
• 发现与管理：themes list/show、layout list/show、providers list 等命令查询可用资源；doctor、config show 诊断本地配置

显著优点

1. 模块化排版系统：支持 hero、verdict、cta 等高级布局模块，基于 body_format 规范（fields/rows/json_object/json_array）结构化渲染
2. 双模式架构：API 模式（默认）提供完整功能；AI 模式降级可用，不静默切换
3. 品牌配置中心：~/.config/md2wechat/brand.md 统一管理 voice、主题偏好、禁用表达
4. 安全凭证隔离：config wechat-accounts 本地只读，不暴露密钥；doctor 仅检查本地就绪状态
5. 确认优先工作流：inspect → preview → convert → upload/draft 的分步确认机制，避免误操作

潜在局限

• 模式互斥限制：高级布局模块仅在 API 模式渲染，AI 模式不解析 :::module 语法
• 凭证依赖较重：API 转换需 MD2WECHAT_API_KEY，微信草稿需微信账号凭证，图片生成需图商密钥
• 模块内容门槛：布局模块要求文章提供足够内容填充，否则需跳过或人工调整
• 本地验证边界：doctor 仅检查配置就绪性，不执行真实认证或上传测试

适合人群

• 微信公众号运营者、内容编辑、品牌市场团队
• 技术写作者、知识付费创作者
• 需要将 Markdown 工作流与微信生态打通的自动化用户

常规风险

• 配置泄露风险：config show 可能暴露本地配置路径，需避免在共享环境执行
• 误发布风险：--upload、--draft 为显式副作用命令，需在 inspect 确认 data.readiness.targets 无 blocker 后执行
• 图片版权风险：generate_image 依赖外部图商，生成内容需人工审核版权合规性
• 标题过度依赖：title suggest 生成候选需人工确认，高 hook-level（2-3）标题需核实事实准确性