● 社区
geekjourneyx
⚡ 即开即用
md2wechat-skill
作者 geekjourneyx · geekjourneyx/md2wechat-skill
用 Markdown 写公众号文章 —— Claude 转换样式、上传图片,直接存入你的公众号后台草稿。
一个 Claude 技能,把 Markdown 草稿转换成格式化的公众号文章。API 模式调用 md2wechat.cn 快速应用主题;AI 模式让 Claude 生成更丰富的自定义样式。支持元数据提取、图片上传到公众号媒体库,以及直接在后台创建草稿。
为什么要用
核心特性
- 两种模式:快速 API 转换(预设主题)或 AI 定制样式
- 自动处理标题、列表、代码块、表格
- 图片处理 + 上传到公众号媒体库
- 封面图生成或集成
- 草稿直接创建到公众号后台
实时演示
实际使用效果
md2wechat-skill.replay
▶ 就绪
使用场景
实战用法: md2wechat-skill
何时使用: 你在 Obsidian/VSCode 写初稿,但怕手动在公众号编辑器里排版。
前置条件
- md2wechat.cn API 密钥 — 在 md2wechat.cn 注册 —— 有免费额度
- 公众号 API 凭据 — 注册你的公众号,获取 AppID/AppSecret
步骤
-
通过 API 模式转换
用 md2wechat-skill 转换 article.md,应用 'modern' 主题后推送到公众号后台。✓ 已复制
→ 应用主题的 HTML + 公众号后台草稿链接
-
在公众号编辑器中审阅
→ 预览与预期一致
结果: 几秒生成发布就绪的公众号草稿,而不是 20 分钟的复制粘贴。
注意事项
- Markdown 里的图片是本地路径 — 技能会把本地图片上传到公众号媒体库 —— 运行器需要能访问这些文件
何时使用: 文章值得定制拉引、标注或视觉层级。
步骤
-
请求 AI 模式
用 md2wechat-skill 的 AI 模式。用温暖的排版和拉引语装饰这篇文章。✓ 已复制
→ Claude 生成比预设主题更丰富的 HTML 样式
-
上传到草稿
→ 返回草稿 ID
结果: 视觉独特的文章,在信息流中脱颖而出。
注意事项
- 过度装饰会影响移动端可读性 — 发布前在手机上预览 —— 微信用户 95% 以上用移动端
组合
与其他 MCP 搭配,撬动十倍杠杆
claude-blog 写文章,md2wechat-skill 发布到公众号
先用 /blog write 新建文章,再用 md2wechat-skill 推送到公众号草稿。✓ 已复制
从本地 markdown 文件库读取草稿
对 ~/wechat-drafts 中每个准备好发布的 .md,转换并推送。✓ 已复制
推荐封面图提示词,外部生成,然后通过本技能上传
从 nano-banana 选封面提示词,用生成的图片发布草稿。✓ 已复制
成本与限制
运行它的成本
- API 配额
- md2wechat.cn 有免费和付费层级;公众号 API 有独立配额
- 每次调用 Token 数
- API 模式低,AI 模式中等
- 费用
- 大部分免费;仅当超过 md2wechat.cn 免费额度时需付费
- 提示
- 日常文章用 API 模式;AI 模式留给精品文章。
安全
权限、密钥、影响范围
凭据存储: md2wechat.cn API 密钥 + 公众号 AppID/AppSecret 放在环境变量。绝不提交。
数据出站: 发往 md2wechat.cn 和公众号官方 API 端点
- 你的草稿会通过 md2wechat.cn —— 不要用 API 模式发送机密内容。
故障排查
常见错误与修复
40001 invalid credential (WeChat)
AppSecret 错误或 access_token 过期。技能应该自动刷新;如果没有,轮换 secret。
Images don't render in WeChat
公众号阻止跨域图片 —— 确保所有图片通过媒体 API 上传。
Conversion API returns 401
md2wechat.cn 密钥缺失或额度用尽 —— 检查仪表板。
替代方案
md2wechat-skill 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
| 手动复制粘贴到公众号编辑器 | 偶尔发文 | 慢但无需配置 |
| Mdnice / Mdx editor | 你想要 web UI 而不是 AI 自动化 | 手动流程,无法直接推送草稿 |