核心功能与用法
md2wechat-skill 是一款面向微信公众号内容创作者的专业排版工具，提供 Markdown 到微信图文的全流程自动化转换能力。核心工作流分为两个层级：基础转换模式（--convert-only）无需任何微信密钥，即可将标准 Markdown 转换为微信编辑器兼容的内联样式 HTML，适合本地预览或第三方发布；完整发布模式（--draft）则通过微信公众号 API 实现一键上传至草稿箱，支持封面图、正文图片自动转存微信 CDN、Front Matter 元数据解析及超长内容安全截断。
技术实现上，工具链基于 Python 生态构建：使用 markdown 库解析 GFM 语法，beautifulsoup4 处理 DOM 结构与内联样式注入，wechatpy 封装微信官方 API，配合 requests 与 pillow 完成图片上传与格式处理。排版引擎针对微信生态做了深度适配——代码块强制深色主题、表格转置为微信支持的格式、所有样式内联化以规避外部 CSS 依赖。
显著优势
- 双模式设计：敏感操作（需微信密钥）与纯本地转换严格分离，降低安全暴露面
- 资产自动化：本地图片路径自动解析上传，永久素材管理零手工
- 元数据驱动：YAML Front Matter 支持标题、作者、定时发布等高级配置
- 微信原生兼容：输出 HTML 直接粘贴或 API 上传均可保持视觉一致性
局限与风险
- 环境依赖重：需 Python 3 及 6 个第三方库，对非技术用户门槛较高
- 密钥管理责任：
WECHAT_APPID与WECHAT_SECRET需用户自行保管，工具本身未提供加密存储机制 - 平台锁定风险：输出 HTML 深度耦合微信内联样式规范，迁移至其他平台需重新排版
- API 限制：微信素材接口有频率与容量限制（单图文 2MB），超大文档可能触发截断
适用人群
技术博主、开发者关系（DevRel）从业者、企业公众号运营团队中具备基础命令行能力的成员。特别适合已有 Markdown 写作习惯、需高频发布且追求排版一致性的内容生产者。
安全建议
建议生产环境使用 --convert-only 模式生成 HTML 后人工复核，再通过微信公众平台后台手动上传；如必须使用自动上传，应将微信密钥配置于受限权限的 CI/CD 变量或专用密钥管理服务，避免写入本地明文 .env 文件。