md2wechat Agent API markAgent API Docs
md2wechat Agent API markAgent API Docs
Homepage

Start

Markdown to WeChat API DocsQuickstartAuth

APIs

Integrations

Operations

ErrorsPricingContact
X (Twitter)

Claude Code

Install md2wechat for Claude Code, verify discovery, and run the first WeChat publishing workflow.

Claude Code

Recommended path

Claude Code works best when you separate the runtime from the skill:

  1. install the md2wechat CLI
  2. install the md2wechat skill
  3. verify discovery before asking Claude to publish anything

Step 1. Install the CLI

If you already have Node and npm, start here:

npm install -g @geekjourneyx/md2wechat

If you prefer Homebrew on macOS:

brew install geekjourneyx/tap/md2wechat

If you already have a stable Go toolchain:

go install github.com/geekjourneyx/md2wechat-skill/cmd/md2wechat@v2.0.7

Fallback:

curl -fsSL https://github.com/geekjourneyx/md2wechat-skill/releases/download/v2.0.7/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"

Step 2. Install the skill

Recommended:

npx skills add https://github.com/geekjourneyx/md2wechat-skill --skill md2wechat

Claude Code users can also install through the plugin marketplace:

/plugin marketplace add geekjourneyx/md2wechat-skill
/plugin install md2wechat@geekjourneyx-md2wechat-skill

Step 3. Verify the runtime

md2wechat version --json
md2wechat config init
md2wechat capabilities --json
md2wechat themes list --json
md2wechat providers list --json

Do not skip discovery. It is the safest way to confirm what the current CLI actually supports.

Step 4. First prompts to send Claude Code

Use one of these directly in Claude Code:

Please run md2wechat capabilities --json first, then convert article.md into WeChat HTML and show me a preview.
Install md2wechat CLI first, then install the md2wechat skill, verify version and capabilities, and stop only after every command succeeds.
Use md2wechat to convert article.md in AI mode with theme autumn-warm, then tell me whether the output is an AI request or final HTML.

Common notes

  • npx skills add installs the skill only. It does not install the CLI for you.
  • convert defaults to API mode unless you pass --mode ai.
  • Creating drafts or uploading materials still needs WeChat credentials and, for API mode, an md2wechat.cn API key.
  • AI mode returns structured output for an external model flow. It is not the same as direct API conversion.

Continue here

  • md2wechat-skill Guide
  • md2wechat-skill FAQ
  • Coding Agents

Table of Contents

Claude Code
Recommended path
Step 1. Install the CLI
Step 2. Install the skill
Step 3. Verify the runtime
Step 4. First prompts to send Claude Code
Common notes
Continue here