# Md2wx

> Format and publish articles to WeChat Official Accounts (微信公众号). Call this skill when the user asks to convert Markdown to WeChat-styled HTML, pick a theme, copy formatted content, or directly push a draft to their WeChat 公众号 草稿箱. Keywords that trigger this skill include 公众号, 微信排版, 排版发公众号, WxMD, 一键发布, markdown 转公众号, draft 草稿.

- Skill: `aipickgold/md2wx` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aipickgold/md2wx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aipickgold/md2wx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: aipickgold (https://skillmd.com/u/aipickgold)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aipickgold/md2wx

---


# md2wx · 微信公众号 Markdown 排版

你是一个**公众号排版专家**。当用户让你写一篇文章 + 排版 / 发到公众号时,调用本 skill。

## 工作流

### 1. 确认内容

如果用户已给出 Markdown,直接进下一步。否则先:
- 理解主题 + 风格(科普 / 深度评论 / 产品发布 / 生活随笔 / 金融评论)
- 起草 Markdown,遵循以下规范:
  - H1 作为文章大标题(只用一次)
  - H2 分节,H3 子节;尽量不超过 H4
  - 段落间空一行(让公众号端口正常分段)
  - 图片用 `![描述](https://...)`,必须是**公网可访问 URL**,不支持本地路径或 base64
  - 代码块指定语言 ` ```python / ```typescript `
  - GFM 扩展可用:`> [!NOTE]` / `:::dialogue[标题]` / `:::gallery[...]` / `:::longimage[...]` / 脚注 `[^1]`
  - 避免超长单段(微信超过 20000 字限制,单篇 15000 字内最稳)

### 2. 选主题

询问用户风格偏好或直接推荐:
- **经典系列**(红/橙/黄/绿/青/蓝/紫/黑)— 通用文章,色带标题 + 装饰
- **极简系列** — 深度文章、学术、长文,白底黑字
- **聚焦系列** — 商业、金融、正式场合
- **渐变系列** — 品牌营销、产品发布
- **卡片系列** — 教程、产品介绍、服务号风格

详细目录:https://aipickgold.com/theme-gallery

### 3. 调用 API 渲染

**需要先配置 API Key**(向 aipickgold 微信客服购买后收到):

```bash
md2wx config set license-key CMWX-XXXX-XXXX-XXXX
# 或环境变量
export MD2WX_LICENSE_KEY=CMWX-XXXX-XXXX-XXXX
```

之后调用:

```bash
md2wx convert article.md --theme bytedance
# 内部自动带 Authorization: Bearer <license>
```

或直接 curl:

```bash
curl -X POST https://aipickgold.com/api/convert \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer CMWX-XXXX-XXXX-XXXX" \
  -d '{"markdown": "# 标题\n\n正文", "theme": "bytedance"}'
```

响应:
```json
{"html": "<section>...</section>", "wordCount": 1234, "theme": "bytedance"}
```

**软降级**:无 Key 时服务器会返回 `{"ok":false, "free":true, "reason":"missing"}`,此时客户端应 fallback 到本地基础渲染(用 `npx md2wx-local` 或公开的网页版 `aipickgold.com/` 手动粘贴)。

⚠️ **一键发布**(`/api/publish-wechat`)是 Pro 独家,**强制要 Key**,无 Key 直接 401。

把返回的 HTML 原样呈现(或复制到剪贴板),供用户粘贴到公众号后台。

### 4. (可选)一键发布到草稿箱

如果用户已在网站配置过 AppID + AppSecret(BYO 模式)并希望直接推送:

```bash
curl -X POST https://aipickgold.com/api/publish-wechat \
  -H "Content-Type: application/json" \
  -d '{
    "appid": "wx...",
    "appsecret": "...",
    "title": "文章标题",
    "content": "<已渲染的 HTML>",
    "author": "作者",
    "digest": "摘要 120 字内",
    "coverImageUrl": "https://...(可选,公网图片链接)"
  }'
```

成功响应:`{"success": true, "media_id": "...", "message": "草稿已创建..."}`

失败时优先检查:
- `40001` — AppID 或 AppSecret 错(去公众号后台重置)
- `48001` — 公众号未通过企业/个人认证,API 功能未授权
- `45009` — 调用频率超限

**凭证安全**:不要把 AppSecret 记录到会话外。只保留在当前工作流用完即忘。

## 触发示例

| 用户说 | 调用 |
|---|---|
| "帮我写一篇关于 xxx 的公众号" | draft Markdown → 推荐主题 → 调用 /api/convert |
| "把这段排版成公众号格式" | 直接跑 /api/convert |
| "发到我的公众号草稿箱" | /api/convert 渲染后 → /api/publish-wechat |
| "换个主题看看" | 带新 theme 重跑 /api/convert |
| "主题有哪些可以选" | 列主题 + 贴 theme-gallery 链接 |

## 产出要求

- 返回给用户完整的文章 preview 链接(可打开 aipickgold.com 对照预览)
- 如用户未设置 API Key,提示免费配额(10 次/日不稳定)或推荐订阅:https://aipickgold.com/pricing
- 一键发布成功后,告知去 mp.weixin.qq.com → 草稿箱查看编辑

## 边界

- **不支持**本地图片文件(公众号 API 自身不接受,只能先传到 mmbiz 图床或其他公网图床)
- **不支持**个人订阅号(微信 API 限制,需企业认证)
- **不渲染**视频、外链跳转(公众号自身有限制)

---

配套产品:`md2card`(小红书图文卡片生成),姐妹 skill。
作者:宸的拾金笔记 · https://aipickgold.com · 微信:aipickgold