核心功能
md2wechat-skill 是一个专为内容创作者设计的 Markdown 转微信工作流工具。它将标准 Markdown 文件通过排版引擎转换为微信图文编辑器兼容的内联样式 HTML，并支持直接调用微信公众号 API 推送至草稿箱。
主要能力
- 完整 Markdown 解析：支持 GitHub Flavored Markdown 全语法，包括标题层级、列表（有序/无序）、表格、代码块、引用、加粗/斜体等
- 智能图片处理：自动将正文内嵌的本地图片上传至微信 CDN 并替换为永久素材链接；支持封面图指定与上传
- Front Matter 元数据：通过 YAML 头信息定义标题、作者、摘要、发布模式等，实现内容管理与发布的解耦
- 代码块深色主题：技术文章友好的代码高亮样式适配
- 安全截断机制：超过微信 2MB 限制的内容自动安全截断，避免发布失败
两种工作模式
1. 纯转换模式（--convert-only）：无需微信密钥，本地生成预览 HTML，适合排版验证
2. 草稿发布模式（--draft）：完整配置后一键上传至微信公众号草稿箱，支持标题、作者、封面等参数覆盖
技术依赖
基于 Python 生态构建，依赖 wechatpy（微信官方 SDK）、markdown（解析器）、beautifulsoup4（HTML 处理）、requests（图片上传）等成熟库。
显著优点
- 极大简化技术作者的内容发布流程，告别微信编辑器的排版痛点
- 内联样式输出确保微信兼容性，无外部 CSS 依赖
- 图片自动化处理省去手动上传替换的繁琐步骤
- 支持命令行参数与配置文件双重配置，灵活适应 CI/CD 场景
潜在局限
- 微信生态绑定：核心功能依赖微信公众号 API，个人号、未认证号受限
- Python 环境依赖：需维护 Python 运行环境及依赖包版本
- API 权限门槛：需要 AppID/AppSecret，对非技术用户配置门槛较高
- 样式定制有限：微信 HTML 规范严格，自定义样式空间有限
适合人群
- 技术博主、开发者运营人员
- 需要批量/自动化发布微信内容的团队
- 习惯 Markdown 写作、厌恶微信原生编辑器的创作者
- 有 CI/CD 集成需求的内容平台
常规风险
- 密钥安全：AppID/AppSecret 需妥善保管，避免泄露至版本控制
- 素材管理：自动上传的图片占用公众号永久素材额度，长期需清理
- API 限流：高频调用可能触发微信 API 频率限制
- 内容合规：自动化发布不替代内容审核，需确保符合微信运营规范