核心功能
md2wechat-skill 是一套面向微信公众号运营者的 Markdown 到微信图文转换工具链，主要提供以下能力：
- 专业排版引擎：将标准 Markdown 完整转换为微信编辑器兼容的内联样式 HTML，涵盖标题层级、列表、表格、代码块、引用等全部语法
- 智能图片处理：自动识别正文本地图片路径，上传至微信 CDN 并替换为永久外链，同时支持封面图素材上传
- 双模式运行：既可纯本地转换为 HTML 预览（无需密钥），也可一键推送至公众号草稿箱
- YAML 元数据：通过 Front Matter 预定义标题、作者、摘要、发布策略等字段，实现内容管理自动化
显著优势
1. 微信生态深度适配：内联样式方案确保渲染结果与微信编辑器 100% 兼容，避免格式错乱
2. 开发友好工作流：保留 Markdown 的书写体验，免除手动复制粘贴排版的繁琐操作
3. 代码块深色主题：技术文章常见的代码片段自动适配深色背景，提升阅读体验
4. 安全截断机制：内容超过微信 2MB 限制时自动处理，防止 API 调用失败
潜在局限
- 依赖微信 API 凭证：草稿箱发布功能需配置 AppID/AppSecret，存在密钥管理门槛
- Python 运行时依赖：需要本地 Python 3 环境及多个第三方库（wechatpy、beautifulsoup4 等）
- 单账号绑定：一次配置仅支持单一公众号，多账号运营需切换环境变量
- 网络依赖：图片上传和草稿发布均需稳定的公网连接
适用人群
- 技术博主与开发者，习惯 Markdown 写作但需在公众号发布
- 新媒体运营团队，追求内容生产流程自动化
- 企业内容中台，需将文档系统与微信生态打通
常规风险
- 密钥泄露风险：AppSecret 若被硬编码或误提交，可能导致公众号被恶意操作
- 图片版权问题：自动上传功能可能将未授权图片传播至微信 CDN
- API 配额消耗：频繁发布测试草稿会占用公众号接口调用次数
- 内容合规性：工具仅负责格式转换，不审核内容，违规内容推送责任由运营者承担
安全建议
使用 .env 文件管理密钥并加入 .gitignore，优先采用 --convert-only 模式在本地验证排版效果后再执行正式上传。