md2wechat

用 Markdown 写公众号文章，像发朋友圈一样简单

🚀 Claude Code 用户（推荐）

在 Claude Code 中运行以下命令即可使用：

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

然后直接对话："请用秋日暖光主题将 article.md 转换为微信公众号格式"

✨ 这是什么？

md2wechat 是一个让你的微信公众号写作更高效的神器。

💡 一句话理解：用 Markdown 写文章 → 一键转换 → 自动发到微信草稿箱

适合谁用？

你是	痛点	md2wechat 帮你
📝 内容创作者	微信编辑器太难用，排版花时间	Markdown 写作，自动排版
💼 产品经理	要发公告，但不会 HTML	不用学代码，一行命令搞定
👨‍💻 程序员	习惯 Markdown，讨厌微信编辑器	保持你的写作习惯
🤖 AI 用户	用 AI 生成内容，但要手动复制粘贴	AI 生成 → 微信草稿，无缝衔接

🎯 核心功能

flowchart LR
    A[用 Markdown 写文章] --> B{选择模式}

    B -->|API 模式| C[调用 md2wechat.cn API]
    C --> D[获取 HTML]

    B -->|AI 模式 推荐| E[Claude AI 生成 HTML]
    E --> F[精美排版]

    D --> G[预览效果]
    F --> G

    G --> H{满意吗}
    H -->|不满意| B
    H -->|满意| I[上传图片]
    I --> J[发送到微信草稿箱]
    J --> K[完成]

    classDef nodeA fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
    classDef nodeE fill:#fff3e0,stroke:#ff9800,color:#e65100
    classDef nodeJ fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
    classDef nodeK fill:#c8e6c9,stroke:#4caf50,color:#1b5e20

    class A nodeA
    class E nodeE
    class J nodeJ
    class K nodeK

两种转换模式

模式	适合谁	特点	样式
API 模式	追求稳定、快速	调用 md2wechat.cn API，秒级响应	简洁专业
AI 模式 ⭐	追求精美排版	Claude AI 生成，样式更丰富	秋日暖光 / 春日清新 / 深海静谧

完整工作流程

flowchart LR
    A1[Markdown 写作] --> A2[插入图片]
    A2 --> B1{选择模式}

    B1 -->|API| B2[md2wechat.cn]
    B1 -->|AI| B3[Claude AI]

    B2 --> B4[HTML 生成]
    B3 --> B4

    B4 --> C1[预览效果]
    C1 --> C2{满意吗}

    C2 -->|调整| B1
    C2 -->|OK| C3[上传图片]
    C3 --> C4[发送草稿]
    C4 --> C5[完成]

    classDef write fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
    classDef ai fill:#fff3e0,stroke:#ff9800,color:#e65100
    classDef done fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
    classDef success fill:#c8e6c9,stroke:#4caf50,color:#1b5e20

    class A1,A2 write
    class B3 ai
    class C4,C5 done

🚀 5分钟快速上手

第一步：下载软件

💡 最新版本：访问 Releases 页面下载

你的系统	下载链接	安装位置
🪟 Windows	下载 .exe	任意文件夹（或 `C:\Windows\System32\`）
🍎 Mac Intel 芯片	下载	`/usr/local/bin/` 或 `~/.local/bin/`
🍎 Mac Apple Silicon (M1/M2/M3)	下载	`/usr/local/bin/` 或 `~/.local/bin/`
🐧 Linux (Intel/AMD)	下载	`/usr/local/bin/` 或 `~/.local/bin/`
🐧 Linux (ARM/树莓派)	下载	`/usr/local/bin/` 或 `~/.local/bin/`

🔍 如何确认 Mac 芯片类型？

点击屏幕左上角 苹果图标 → 关于本机

查看「芯片」或「处理器」信息：

显示 Apple M1/M2/M3/M4 → 下载 Apple Silicon 版本

显示 Intel → 下载 Intel 版本

安装步骤：

Windows 安装方法

下载 md2wechat-windows-amd64.exe
重命名为 md2wechat.exe（可选）
放到任意文件夹，或复制到 C:\Windows\System32\（全局可用）
打开 CMD 或 PowerShell，输入 md2wechat --help 测试

Mac 安装方法

请根据你的芯片类型选择对应命令：

Apple Silicon (M1/M2/M3/M4)：

# 下载并移动到系统目录
curl -Lo md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-darwin-arm64
chmod +x md2wechat
sudo mv md2wechat /usr/local/bin/

# 测试
md2wechat --help

Intel 芯片：

# 下载并移动到系统目录
curl -Lo md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-darwin-amd64
chmod +x md2wechat
sudo mv md2wechat /usr/local/bin/

# 测试
md2wechat --help

用户目录安装（无需 sudo）：

# Apple Silicon
mkdir -p ~/.local/bin
curl -Lo ~/.local/bin/md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-darwin-arm64
chmod +x ~/.local/bin/md2wechat

# Intel 芯片（将上面 URL 中的 arm64 改为 amd64）

# 添加到 PATH（如果还没有）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 测试
md2wechat --help

Linux 安装方法

请根据你的架构选择对应命令：

Intel/AMD (x86_64)：

# 下载并移动到系统目录
curl -Lo md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-linux-amd64
chmod +x md2wechat
sudo mv md2wechat /usr/local/bin/

# 测试
md2wechat --help

ARM/树莓派 (aarch64)：

# 下载并移动到系统目录
curl -Lo md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-linux-arm64
chmod +x md2wechat
sudo mv md2wechat /usr/local/bin/

# 测试
md2wechat --help

用户目录安装（无需 sudo）：

mkdir -p ~/.local/bin
# Intel/AMD 用 amd64，ARM 用 arm64
curl -Lo ~/.local/bin/md2wechat https://github.com/geekjourneyx/md2wechat-skill/releases/latest/download/md2wechat-linux-amd64
chmod +x ~/.local/bin/md2wechat

# 添加到 PATH（如果还没有）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

# 测试
md2wechat --help

⚠️ Mac 用户：下载后如果提示「无法打开」，右键点击 → 打开 → 仍要打开

第二步：配置微信（只需一次）

md2wechat config init

用记事本打开生成的配置文件（会显示路径），填入两个信息：

配置项	是什么	在哪获取
AppID	公众号唯一标识	mp.weixin.qq.com → 设置与开发 → 基本配置
Secret	API 密钥	同上，需要管理员权限

第三步：开始使用

# 1. 用 Markdown 写好文章（假设文件叫 article.md）

# 2. 预览效果
md2wechat convert article.md --preview

# 3. 发送到微信草稿箱
md2wechat convert article.md --draft --cover cover.jpg

💡 小贴士：第一次使用时，命令会自动引导你完成配置。

📖 使用方法

基础命令

# 预览转换效果（不发送）
md2wechat convert article.md --preview

# 转换并保存为 HTML 文件
md2wechat convert article.md -o output.html

# 使用 AI 模式生成精美排版
md2wechat convert article.md --mode ai --theme autumn-warm --preview

完整发布流程

# 一步到位：转换 + 上传图片 + 发送草稿
md2wechat convert article.md --draft --cover cover.jpg

# 流程说明：
# 1. 将 Markdown 转换为微信格式 HTML
# 2. 上传封面图片到微信素材库
# 3. 创建草稿并推送到微信后台

AI 模式主题选择

主题名	命令	风格	适合内容
🟠 秋日暖光	`--theme autumn-warm`	温暖橙色调	情感故事、生活随笔
🟢 春日清新	`--theme spring-fresh`	清新绿色调	旅行日记、自然主题
🔵 深海静谧	`--theme ocean-calm`	专业蓝色调	技术文章、商业分析

API 模式主题选择

主题名	命令	风格	适合内容
默认	`--mode api` 或默认	简洁专业	通用内容
bytedance	`--theme bytedance`	字节跳动风格	科技资讯
apple	`--theme apple`	Apple 极简风格	产品评测
sports	`--theme sports`	运动活力风格	体育内容
chinese	`--theme chinese`	中国传统文化风格	文化文章
cyber	`--theme cyber`	赛博朋克风格	前沿科技

图片处理

# 上传单张图片到微信素材库
md2wechat upload_image photo.jpg

# 下载网络图片并上传
md2wechat download_and_upload https://example.com/image.jpg

# AI 生成图片并上传（需要配置 IMAGE_API_KEY）
md2wechat generate_image "A cute cat sitting on a windowsill"

AI 图片生成

在 Markdown 中使用特殊语法生成图片：

![产品概念图](__generate:现代智能家居设备，白色简约设计，LED指示灯__)

语法格式： ![描述](__generate:提示词__)

支持中文和英文提示词
生成的图片会自动上传到微信素材库
需要配置图片生成服务（详见图片服务配置文档)

在 Claude Code 中使用自然语言：

"帮我在文章开头生成一张产品概念图"
"在第三段后添加一张对比图"
"生成一张可爱的猫"（独立生成，不关联文章）

🤖 AI 模式详解

什么是 AI 模式？

AI 模式使用 Claude 大模型来生成精美的公众号排版，而不是简单的 API 转换。

┌─────────────────────────────────────────────────────────────┐
│                     AI 模式工作流程                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   1. 你用 Markdown 写文章                                    │
│              ↓                                               │
│   2. md2wechat 提取文章结构                                  │
│              ↓                                               │
│   3. 构建专业的排版提示词 (Prompt)                           │
│              ↓                                               │
│   4. Claude AI 根据提示词生成 HTML                          │
│              ↓                                               │
│   5. 返回符合微信规范的 HTML                                 │
│                                                             │
└─────────────────────────────────────────────────────────────┘

AI 模式的优势

对比项	API 模式	AI 模式
响应速度	⚡ 秒级	🐢 10-30秒
排版质量	👍 标准规范	🌟 精美多样
样式选择	2-3 种	无限可能
成本	低	使用 Claude AI
适合场景	日常文章	重要文章、品牌内容

在 Claude Code 中使用 AI 模式

如果你使用 Claude Code，AI 模式会自动调用内置的 Claude，无需额外配置：

# 在 Claude Code 中直接运行
md2wechat convert article.md --mode ai --theme autumn-warm

⚙️ 配置说明

配置文件位置

~/.config/md2wechat/config.yaml    # 全局配置（推荐）

配置项说明

# 微信公众号配置（必需）
wechat:
  appid: "你的AppID"
  secret: "你的Secret"

# API 配置
api:
  md2wechat_key: "md2wechat.cn 的 API Key"  # API 模式需要
  convert_mode: "api"                       # 默认模式：api 或 ai
  default_theme: "default"                  # 默认主题
  http_timeout: 30                          # 超时时间（秒）

# 图片处理配置
image:
  compress: true           # 自动压缩大图
  max_width: 1920         # 最大宽度
  max_size_mb: 5          # 最大文件大小（MB）

📁 项目结构

md2wechat-skill/
├── cmd/                    # 命令行工具
│   └── md2wechat/         # 主程序
├── internal/              # 核心功能模块
│   ├── converter/        # 转换器（API/AI）
│   ├── draft/            # 草稿服务
│   ├── image/            # 图片处理
│   ├── wechat/           # 微信 API 封装
│   └── config/           # 配置管理
├── docs/                 # 详细文档
│   ├── USAGE.md          # 使用教程
│   ├── FAQ.md            # 常见问题
│   └── TROUBLESHOOTING.md # 故障排查
├── examples/             # 示例文章
├── scripts/              # 安装脚本
└── bin/                  # 编译好的二进制文件

🔧 高级安装

方式一：Go 工具链

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

方式二：一键安装脚本

Mac/Linux：

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

💡 脚本会自动检测你的系统架构并下载对应版本

Windows PowerShell：

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/geekjourneyx/md2wechat-skill/main/scripts/install.ps1'))

方式三：从源码编译

git clone https://github.com/geekjourneyx/md2wechat-skill.git
cd md2wechat-skill
make build

🤖 Claude Code 集成

md2wechat 提供了 Claude Code Skill，让你在 Claude Code 中直接使用自然语言转换文章。

安装方式

方式一：Plugin Marketplace（推荐，最简单）

在 Claude Code 中运行以下命令：

# 添加插件市场
/plugin marketplace add geekjourneyx/md2wechat-skill

# 安装插件
/plugin install md2wechat@geekjourneyx-md2wechat-skill

安装后，直接在 Claude Code 中对话即可使用：

请用秋日暖光主题将 article.md 转换为微信公众号格式

方式二：项目内使用

克隆项目后，Skill 自动可用：

git clone https://github.com/geekjourneyx/md2wechat-skill.git
cd md2wechat-skill
# 在 Claude Code 中直接使用

方式三：全局安装

将 Skill 复制到全局目录：

# 复制到全局技能目录
cp -r skill/md2wechat ~/.claude/skills/

方式四：创建符号链接

ln -s /path/to/md2wechat-skill/skill/md2wechat ~/.claude/skills/md2wechat

项目结构

md2wechat-skill/
├── .claude-plugin/        # 插件清单
│   └── plugin.json
├── skill/                 # Claude Code Skill
│   └── md2wechat/
│       ├── SKILL.md       # 技能定义
│       ├── references/    # 参考文档
│       │   ├── themes.md      # 主题指南
│       │   ├── html-guide.md  # HTML 规范
│       │   ├── image-syntax.md # 图片语法
│       │   └── wechat-api.md  # API 参考
│       └── scripts/       # 执行脚本
└── themes/                # AI 主题配置
    ├── autumn-warm.yaml
    ├── spring-fresh.yaml
    └── ocean-calm.yaml

🎓 使用示例

示例 1：技术博主

# 写好技术文章
vim my-tech-post.md

# 使用简洁的 API 模式转换
md2wechat convert my-tech-post.md --preview

# 满意后发送草稿
md2wechat convert my-tech-post.md --draft --cover cover.jpg

示例 2：产品经理发公告

# AI 生成产品公告内容，然后
md2wechat convert announcement.md --mode ai --theme ocean-calm --draft --cover product-logo.png

示例 3：生活方式博主

# 使用春日清新主题
md2wechat travel-diary.md --mode ai --theme spring-fresh --preview

❓ 常见问题

Q: 必须要会编程才能用吗？

A: 不需要！ 只要会用命令行（终端）就可以。如果是 Windows 用户，下载 .exe 文件后，在 CMD 或 PowerShell 中运行命令即可。

Q: AI 模式需要付费吗？

A: AI 模式使用 Claude 能力：

如果你在 Claude Code 中使用，直接调用内置 AI
如果你想自己接入，需要配置 OpenAI 兼容的 API

Q: 支持哪些 Markdown 语法？

A: 支持常用语法：

标题（# ## ###）
列表（无序、有序）
粗体、斜体、行内代码
代码块（带语法高亮）
引用块
分割线
图片、链接
表格

Q: 生成的文章可以直接在微信编辑器中编辑吗？

A: 可以！草稿发送后，你可以登录微信公众平台，在草稿箱中继续编辑。

Q: 如何知道应该下载哪个版本？下载错了怎么办？

A:

Mac 用户：

点击屏幕左上角苹果图标 → 「关于本机」
看到 Apple M1/M2/M3/M4 → 下载 Apple Silicon (arm64) 版本
看到 Intel → 下载 Intel (amd64) 版本

Linux 用户：

运行 uname -m 命令
输出 x86_64 → 下载 amd64 版本
输出 aarch64 → 下载 arm64 版本

如果下载错了：

删除错误的文件，重新下载正确版本即可
也可以使用一键安装脚本，会自动检测系统架构

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

📚 更多文档

文档	说明
新手入门指南	强烈推荐！详细的图文教程
完整使用说明	所有命令和选项
常见问题	20+ 常见问题解答
故障排查	遇到问题看这里

🤝 贡献

欢迎提交 Issue 和 Pull Request！

如果你有好的想法或发现了 bug，请随时提 issue。

📄 许可证

MIT License

👨‍💻 作者

geekjourney — 极客/创作者/AI 探索者

🌐 个人主页: geekjourney.dev
🐦 X/Twitter: @seekjourney
📱 公众号: 极客杰尼

让公众号写作更简单 ⭐

主页 • 文档 • 反馈

Made with ❤️ by geekjourney

Name		Name	Last commit message	Last commit date
.claude-plugin		.claude-plugin
.github/workflows		.github/workflows
cmd/md2wechat		cmd/md2wechat
docs		docs
examples		examples
internal		internal
plugins/md2wechat/skills/md2wechat		plugins/md2wechat/skills/md2wechat
scripts		scripts
skill/md2wechat		skill/md2wechat
themes		themes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
DESIGN.md		DESIGN.md
Makefile		Makefile
QUICKSTART.md		QUICKSTART.md
README.md		README.md
SKILL-RULE.md		SKILL-RULE.md
go.mod		go.mod
go.sum		go.sum

Latest commit

History

Folders and files

Repository files navigation