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

md2wechat-skill

作者 geekjourneyx · geekjourneyx/md2wechat-skill

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

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

为什么要用

核心特性

实时演示

实际使用效果

md2wechat-skill.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "md2wechat-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "md2wechat-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/geekjourneyx/md2wechat-skill",
          "~/.claude/skills/md2wechat-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add md2wechat-skill -- git clone https://github.com/geekjourneyx/md2wechat-skill ~/.claude/skills/md2wechat-skill

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: 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