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

Coding Agents

面向 Claude Code、Codex、OpenCode、Claudian 和 OpenClaw 的 md2wechat 实战接入总览。

Coding Agents

这一页用来快速说明 md2wechat-skill 在不同 Agent 运行环境里的使用方式。

Claude Code、Codex、OpenCode 的共同规则

对 Coding Agent 这条路径,始终按这个顺序理解:

  1. 先装 CLI
  2. 再装 skill
  3. 先做 discovery
  4. 最后执行真正任务

如果你已经有 Node 和 npm,推荐命令:

npm install -g @geekjourneyx/md2wechat
npx skills add https://github.com/geekjourneyx/md2wechat-skill --skill md2wechat
md2wechat version --json
md2wechat capabilities --json

如果你更习惯 macOS 下的 Homebrew,也可以把第一条换成:

brew install geekjourneyx/tap/md2wechat

如果你走的是 install.sh,先刷新 PATH:

export PATH="$HOME/.local/bin:$PATH"

Discovery-first 工作流

不要靠猜当前运行时状态,先问 CLI:

md2wechat capabilities --json
md2wechat providers list --json
md2wechat themes list --json
md2wechat prompts list --kind image --json

这样 Agent 才知道:

  • 默认模式是什么
  • 当前有哪些 provider 已配置
  • 当前有哪些主题
  • 有哪些 prompt preset 可用

不同运行时的差异

运行时推荐安装方式关键注意点
Claude CodeCLI + npx skills add虽然也有插件市场,但 CLI 仍然是前提
CodexCLI + npx skills add和 Claude Code 共用 skill 路径
OpenCodeCLI + npx skills add和 Claude Code 共用 skill 路径
ClaudianCLI + npx skills addGUI 进程的 PATH 经常和终端不同
OpenClawOpenClaw installer 或 ClawHub + CLI用的是独立 skill 包和独立 skills 目录

可以交给任意 Coding Agent 的起手任务

请先安装 md2wechat CLI,再安装 md2wechat skill,验证 version 和 capabilities,所有命令成功后再结束。
请先运行 md2wechat capabilities --json,再把 article.md 转成公众号 HTML,并给我一个预览版本。
请用 md2wechat 的 AI 模式处理文章,并告诉我当前结果是最终 HTML,还是还需要第二步模型继续处理的 AI request。

关键提醒

  • npx skills add 只安装 skill
  • convert 默认走 API 模式
  • AI 模式是显式开启的,而且是多步骤流程
  • 发草稿依然需要微信凭证
  • OpenClaw 不属于这条共享 skill 路径

环境细分页面

  • Claude Code
  • Codex
  • OpenCode
  • Claudian
  • OpenClaw

如果你想把这条接入线走得更稳,再继续看:

  • Setup and Troubleshooting
  • Discovery-First Workflow
  • Mode Selection

Examples

md2wechat 在 Claude Code、Codex、OpenCode、Claudian、OpenClaw、Cursor 和 Raw API 场景下的接入示例。

Release Post Example

新版本发布稿怎么用高级排版,先讲更新值不值得看,再把改动和动作收住。

目录

Coding Agents
Claude Code、Codex、OpenCode 的共同规则
Discovery-first 工作流
不同运行时的差异
可以交给任意 Coding Agent 的起手任务
关键提醒
环境细分页面