/ Directory / Playground / wechat-article-formatter-skill
● Community iamzifei ⚡ Instant

wechat-article-formatter-skill

by iamzifei · iamzifei/wechat-article-formatter-skill

Format markdown articles for 微信公众号 publishing — turn a draft into properly-styled WeChat-ready HTML with one prompt.

WeChat公众号's editor is notoriously picky about HTML. This skill takes a Markdown article and produces the inline-styled HTML WeChat accepts — headings, quotes, code blocks, images all rendered in your chosen theme. Supports custom styling.

Why use it

Key features

Live Demo

What it looks like in practice

wechat-article-formatter-skill.replay ▶ ready
0/0

Install

Pick your client

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

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

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

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

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

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

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

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

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

Continue uses an array of server objects rather than a map.

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

Add to context_servers. Zed hot-reloads on save.

claude mcp add wechat-article-formatter-skill -- git clone https://github.com/iamzifei/wechat-article-formatter-skill ~/.claude/skills/wechat-article-formatter-skill

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use wechat-article-formatter-skill

Publish a technical article to 公众号 without formatting pain

👤 Chinese-speaking tech writers, 运营 ⏱ ~10 min beginner

When to use: You wrote in Markdown and need to post to WeChat within 15 minutes.

Prerequisites
  • Skill installed — git clone https://github.com/iamzifei/wechat-article-formatter-skill ~/.claude/skills/wechat-article-formatter-skill
Flow
  1. Feed the draft
    使用 wechat-article-formatter-skill. 这是我的Markdown文章,帮我转成公众号可用的HTML:[paste draft]✓ Copied
    → Inline-styled HTML output with proper heading hierarchy
  2. Tweak the theme
    把主色从蓝色换成绿色,正文字号略小一点。✓ Copied
    → Updated HTML with theme diff
  3. Copy and paste
    给我最终版本,我要复制到公众号编辑器。✓ Copied
    → Clean HTML block ready for WeChat

Outcome: An article that looks good on WeChat without manual CSS fighting.

Pitfalls
  • Images break — WeChat requires re-uploaded images — Upload images in WeChat's media library first; skill leaves img placeholders

Build a reusable brand theme for every post

👤 公众号 teams wanting visual consistency ⏱ ~20 min intermediate

When to use: You're about to post the 10th article and realize each one looks different.

Flow
  1. Define the theme
    用 wechat-article-formatter-skill 帮我定义品牌主题: 主色 #1A73E8,标题 PingFang,正文行距 1.8。✓ Copied
    → Saved theme file with all token defaults
  2. Apply across drafts
    对 drafts/ 里的所有文章应用这个主题。✓ Copied
    → Batch-formatted HTMLs

Outcome: Every post looks like it came from the same brand.

Combine with: filesystem

Combinations

Pair with other MCPs for X10 leverage

wechat-article-formatter-skill + filesystem

Batch-format a drafts/ folder

格式化 drafts/ 里的每一篇文章,输出到 formatted/。✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
format_article markdown, theme name Every article 0
save_theme theme spec Once per brand 0
preview_html html string Before pasting 0

Cost & Limits

What this costs to run

API quota
None
Tokens per call
Modest — text in, HTML out
Monetary
Free
Tip
Save theme once; don't re-specify every article.

Security

Permissions, secrets, blast radius

Credential storage: None
Data egress: None from skill

Troubleshooting

Common errors and fixes

Layout broken after paste into WeChat

WeChat stripped something; re-run with fallback inline styles

Images missing

Upload to WeChat media library and replace placeholders manually

Code blocks don't preserve language highlighting

WeChat doesn't support JS-based highlighters; skill bakes colors inline — verify the theme has them

Alternatives

wechat-article-formatter-skill vs others

AlternativeWhen to use it insteadTradeoff
md2wechat / wechat-format online toolsOne-off, no Claude integrationCan't batch; no customization via prompts
wechat-article-publisher-skillYou want to auto-publish, not just formatRequires WeChat API credentials

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills