/ 目录 / 演练场 / md2wechat-skill
● 社区 geekjourneyx ⚡ 即开即用

md2wechat-skill

作者 geekjourneyx · geekjourneyx/md2wechat-skill

用 Markdown 写公众号文章 —— Claude 转换样式、上传图片,直接存入你的公众号后台草稿。

一个 Claude 技能,把 Markdown 草稿转换成格式化的公众号文章。API 模式调用 md2wechat.cn 快速应用主题;AI 模式让 Claude 生成更丰富的自定义样式。支持元数据提取、图片上传到公众号媒体库,以及直接在后台创建草稿。

为什么要用

核心特性

实时演示

实际使用效果

md2wechat-skill.replay ▶ 就绪
0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法: md2wechat-skill

一步把 Markdown 草稿转成公众号草稿

👤 喜欢用 Markdown 写作的运营 / 公众号编辑 ⏱ ~5 min beginner

何时使用: 你在 Obsidian/VSCode 写初稿,但怕手动在公众号编辑器里排版。

前置条件
  • md2wechat.cn API 密钥 — 在 md2wechat.cn 注册 —— 有免费额度
  • 公众号 API 凭据 — 注册你的公众号,获取 AppID/AppSecret
步骤
  1. 通过 API 模式转换
    用 md2wechat-skill 转换 article.md,应用 'modern' 主题后推送到公众号后台。✓ 已复制
    → 应用主题的 HTML + 公众号后台草稿链接
  2. 在公众号编辑器中审阅
    (手动操作 —— 打开草稿)✓ 已复制
    → 预览与预期一致

结果: 几秒生成发布就绪的公众号草稿,而不是 20 分钟的复制粘贴。

注意事项
  • Markdown 里的图片是本地路径 — 技能会把本地图片上传到公众号媒体库 —— 运行器需要能访问这些文件
搭配使用: filesystem

用 AI 模式为长文赋予独特的视觉风格

👤 想要超越模板主题的创作者 ⏱ ~15 min intermediate

何时使用: 文章值得定制拉引、标注或视觉层级。

步骤
  1. 请求 AI 模式
    用 md2wechat-skill 的 AI 模式。用温暖的排版和拉引语装饰这篇文章。✓ 已复制
    → Claude 生成比预设主题更丰富的 HTML 样式
  2. 上传到草稿
    现在推送到公众号后台。✓ 已复制
    → 返回草稿 ID

结果: 视觉独特的文章,在信息流中脱颖而出。

注意事项
  • 过度装饰会影响移动端可读性 — 发布前在手机上预览 —— 微信用户 95% 以上用移动端
搭配使用: claude-blog-skill

组合

与其他 MCP 搭配,撬动十倍杠杆

md2wechat-skill + claude-blog-skill

claude-blog 写文章,md2wechat-skill 发布到公众号

先用 /blog write 新建文章,再用 md2wechat-skill 推送到公众号草稿。✓ 已复制
md2wechat-skill + filesystem

从本地 markdown 文件库读取草稿

对 ~/wechat-drafts 中每个准备好发布的 .md,转换并推送。✓ 已复制

推荐封面图提示词,外部生成,然后通过本技能上传

从 nano-banana 选封面提示词,用生成的图片发布草稿。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
API 转换(主题预设) markdown + 主题名 快速应用主题 md2wechat.cn 额度
AI 样式模式 markdown + 样式描述 超越预设的定制风格 仅消耗 LLM tokens
图片上传 image paths / URLs 如果包含图片,在创建草稿前执行 0(公众号 API)
草稿创建 HTML + metadata + media IDs 最后一步 0
封面图生成 article or custom brief 未提供封面时 取决于生成器

成本与限制

运行它的成本

API 配额
md2wechat.cn 有免费和付费层级;公众号 API 有独立配额
每次调用 Token 数
API 模式低,AI 模式中等
费用
大部分免费;仅当超过 md2wechat.cn 免费额度时需付费
提示
日常文章用 API 模式;AI 模式留给精品文章。

安全

权限、密钥、影响范围

凭据存储: md2wechat.cn API 密钥 + 公众号 AppID/AppSecret 放在环境变量。绝不提交。
数据出站: 发往 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 自动化手动流程,无法直接推送草稿

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills