md2wechat-lite

@geekjourneyx · 收录于 1 周前

Manages md2wx CLI for converting Markdown to WeChat Official Account drafts. Use when working with WeChat article publishing, Markdown to HTML conversion, or WeChat media upload.

场景公众号排版内容发布

适合你，如果经常需要把 Markdown 文章发布到微信公众号

/ 下载安装

md2wechat-lite.skill双击,或拖进 Claude 桌面版 / Cowork,即完成安装↓ .skill ↓ .zip

用别的 agent?下载 .zip 解压,把文件夹放进它的技能目录

Claude Code~/.claude/skills/(项目级 .claude/skills/)

Codex CLI~/.codex/skills/

Cursor自动读取上面两处目录

其他工具见其文档的「skills」目录;两个下载是同一份文件,只是名字不同

/ 通过 npx 安装 校验哈希

npx oh-my-skill add geekjourneyx/md2wechat-lite/md2wechat-lite

/ 通过 bash 安装

curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- geekjourneyx/md2wechat-lite/md2wechat-lite

/ 已经装过?验证本机副本,不用重装

npx oh-my-skill verify geekjourneyx/md2wechat-lite/md2wechat-lite

安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。

83GitHub stars

~732上下文体积 · 单文件

镜像托管

怎么用

技能原文 SKILL.md作者撰写 · MIT · f87cdd9

md2wx - Markdown to WeChat

CLI tool for converting Markdown to WeChat Official Account formatted drafts.

Quick start

Install:

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/md2wechat-lite/main/cli/scripts/install.sh | sh

Configure credentials:

md2wx config set wechat-appid "wx123..."
md2wx config set wechat-appsecret "your_secret"
md2wx config set api-key "wme_your_key"

Commands

| Command | Purpose | |---------|---------| | article-draft | Create article draft from Markdown | | newspic-draft | Create Xiaolvshu (image card) draft | | batch-upload | Upload images to WeChat CDN | | themes list | List available themes | | config | Manage settings (set/get/list/path) |

Article draft

Convert Markdown to WeChat article:

md2wx article-draft --file article.md --theme bytedance --cover-image "https://cdn.example.com/cover.jpg"

Or pass inline Markdown:

md2wx article-draft --markdown "# Title\n\nContent" --theme elegant-red --cover-image "https://cdn.example.com/cover.jpg"

Note:

article-draft does not read from stdin pipe directly.
For API compatibility, always provide --cover-image with a public URL.

Newspic draft

Create image-rich card drafts:

md2wx newspic-draft --title "标题" --content "内容" --images "https://cdn.example.com/img1.jpg,https://cdn.example.com/img2.png"

Batch upload

Upload images and get WeChat CDN URLs:

md2wx batch-upload --images "https://cdn.example.com/a.jpg,https://cdn.example.com/b.jpg"

Image input constraints:

API accepts public image URLs only.
Local file paths and glob patterns are not supported.

Themes

Built-in (6): default, bytedance, chinese, apple, sports, cyber

Template (32): {minimal|focus|elegant|bold}-{gold|green|blue|orange|red|navy|gray|sky}

List/search themes:

md2wx themes list [--verbose] [--search query]

For theme descriptions: See cli/pkg/themes/list.go

Configuration

Config file: ~/.md2wx/config.yaml (stored as key=value lines)

Priority: Command args > Environment vars > Config file > Defaults

Environment variables:

MD2WX_WECHAT_APPID
MD2WX_WECHAT_APPSECRET
MD2WX_API_KEY
MD2WX_API_BASE_URL
MD2WX_DEFAULT_THEME
MD2WX_BACKGROUND_TYPE
MD2WX_FONT_SIZE

Project structure

cli/
├── main.go              # Root command
├── article-draft.go     # Article draft
├── newspic-draft.go     # Xiaolvshu draft
├── batch-upload.go      # Image upload
├── config.go            # Config management
├── themes.go            # Theme list command
└── pkg/
    ├── api/client.go    # HTTP API client
    ├── config/          # Config file I/O
    ├── themes/          # Theme definitions
    └── output/          # JSON formatter

Output format

All commands output JSON:

{
  "success": true,
  "data": { "media_id": "...", "url": "..." }
}

Implementation details

Zero dependencies (except cobra): Manual key=value config parsing
Go 1.24+ required
Single binary distribution

See source files for:

API client: cli/pkg/api/client.go
Config handling: cli/pkg/config/config.go
Theme list: cli/pkg/themes/list.go

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。

…