md2wechat Agent API markAgent API 文档
md2wechat Agent API markAgent API 文档
首页

开始

Markdown 转微信公众号 API 文档QuickstartAuth

接口

接入

ExamplesCoding AgentsRelease Post ExampleTutorial Post ExampleService Page ExampleClaude CodeCodexOpenCodeClaudianOpenClawCursor

运维

ErrorsPricingContact
X (Twitter)
Examples

Claude Code

在 Claude Code 中安装 md2wechat、完成能力发现,并跑通第一次公众号排版流程。

Claude Code

推荐路径

Claude Code 最稳的做法,是把 CLI 和 skill 分开安装:

  1. 先装 md2wechat CLI
  2. 再装 md2wechat skill
  3. 先做 discovery,再让 Claude 开始排版和发草稿

第一步:安装 CLI

如果你已经有 Node 和 npm,优先:

npm install -g @geekjourneyx/md2wechat

macOS 如果更习惯 Homebrew:

brew install geekjourneyx/tap/md2wechat

如果你已经有稳定的 Go 环境:

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

兜底方案:

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

第二步:安装 skill

推荐方式:

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

Claude Code 也可以走插件市场:

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

第三步:验证运行时

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

不要跳过 discovery。它是确认当前 CLI 真实能力边界的最稳方式。

第四步:直接发给 Claude Code 的提示词

你可以直接把下面的话发给 Claude Code:

请先运行 md2wechat capabilities --json,确认当前能力后,再把 article.md 转成公众号 HTML,并给我一个预览版本。
请先安装 md2wechat CLI,再安装 md2wechat skill,验证 version 和 capabilities,所有命令成功后再结束。
请用 md2wechat 的 AI 模式处理 article.md,主题用 autumn-warm,并告诉我当前拿到的是 AI request 还是最终 HTML。

注意事项

  • npx skills add 只装 skill,不会自动装 CLI
  • convert 不传 --mode 时默认走 API 模式
  • 要创建草稿或上传素材,仍然需要微信凭证;API 模式还需要 md2wechat.cn 的 API Key
  • AI 模式返回的是给外部模型继续处理的结构化输出,不等于直接生成 HTML

继续阅读

  • md2wechat-skill 使用指南
  • md2wechat-skill FAQ
  • Coding Agents 总览

Service Page Example

服务介绍页别一上来只讲自己。这页给一个先筛人、再讲差异、最后收动作的结构。

Codex

在 Codex 任务里安装 md2wechat、完成能力发现,并通过直接提示词跑通排版和草稿流程。

目录

Claude Code
推荐路径
第一步:安装 CLI
第二步:安装 skill
第三步:验证运行时
第四步:直接发给 Claude Code 的提示词
注意事项
继续阅读