核心用法
md2wechat-skill 是一个面向微信公众号内容生产的技术型工具，解决 Markdown 写作者向微信生态迁移的排版痛点。其工作流程分为两条路径：
本地预览模式（`--convert-only`）：无需任何微信账号配置，将标准 Markdown 转换为内联样式的 HTML 文件，支持标题层级、表格、代码块、引用等完整语法，生成结果可直接在浏览器预览或人工复制到微信编辑器。
自动草稿模式（`--draft`）：在转换基础上，调用微信公众号 API 将图文直接推送至草稿箱。此模式下工具自动完成：图片批量上传至微信 CDN 并替换永久链接、封面图素材化、超长内容安全截断（2MB 限制），大幅降低运营者的重复劳动。
显著优点
1. 零配置快速上手：纯转换模式脱敏运行，不触碰任何微信密钥即可体验核心能力；需要发布时仅需配置 AppID/Secret 两个参数。
2. 完整 Markdown 生态兼容：基于 markdown + beautifulsoup4 构建的转换引擎，支持 GFM 表格、任务列表、代码块高亮（深色主题）等微信原生编辑器难以直接粘贴的复杂格式。
3. 自动化素材管理：本地相对路径引用的图片自动解析、上传、替换，告别手动「本地上传→复制链接→替换 Markdown 语法」的低效流程。
4. Front Matter 元数据驱动：通过 YAML 头信息预置标题、作者、摘要、定时发布等字段，实现「文件即配置」的 Git 友好工作流。
潜在局限与风险
- 微信 API 依赖：草稿发布功能完全依赖微信服务器稳定性，且受限于公众号接口频次（每日新增素材 500 篇上限）。
- 样式隔离性：生成 HTML 采用内联 CSS 硬编码，无法继承公众号自定义模板，品牌视觉统一需人工二次调整。
- 图片尺寸隐忧：微信对素材图片有 2MB 大小与长宽像素限制，工具虽提供截断保护，但极端分辨率图片仍可能上传失败。
- 密钥管理责任：AppSecret 属于敏感凭证，若用户误将
.env文件提交至公共仓库，存在账号被盗用的供应链安全风险。
适合人群
- 技术博客作者、开发者社区运营者，习惯 Markdown 写作但需要分发至微信公众号
- 多平台内容矩阵运营团队，追求「一份 Markdown 源文件 → 多渠道发布」的效率方案
- 对微信编辑器排版限制感到困扰的资深运营者
常规风险提示
建议在 CI/CD 流程中集成 --convert-only 模式生成 HTML 产物，经人工预览后再执行 --draft 推送；生产环境密钥建议通过专用 Secret 管理服务（如 GitHub Actions Secrets、Doppler）注入，避免本地明文 .env 文件泄露。