publish.md

publish：发布文章到微信公众号

publish 命令用于将 Markdown 内容转换为微信公众号兼容格式，并上传至公众号草稿箱。

CLI 会自动处理图片上传、HTML 渲染和草稿创建，无需手动操作微信公众号后台。

支持两种文章类型：

• 图文文章：以文字为主体的常规公众号文章
• 图片消息（小绿书）：以图片为主体的图集内容，在公众号中显示为小绿书样式

工作流程

执行 wenyan publish 时，CLI 自动完成以下步骤：

1. 读取 Markdown 内容（文件 / stdin / 直接输入）
2. 解析 frontmatter（标题、封面等元数据）
3. 如果设置 type: image，自动从正文提取图片路径
4. 自动检测正文和封面中的图片
5. 上传图片到微信公众号素材库
6. 将 Markdown 渲染为微信公众号兼容 HTML（图文文章）/ 直接使用原始内容（小绿书）
7. 创建公众号草稿
8. 返回发布结果

内容输入方式

支持三种输入方式，按需选择。

1. 从本地文件读取（推荐）

最常见使用方式：

wenyan publish -f article.md

支持：

• 相对路径
• 绝对路径

例如：

wenyan publish -f ./posts/article.md

2. 从标准输入（stdin）读取

适用于管道操作和自动化场景：

cat article.md | wenyan publish

或：

echo "# 自动生成的文章" | wenyan publish

适用于：

• CI/CD
• AI 自动生成内容
• 脚本批量发布

3. 直接传入 Markdown 内容

适用于快速发布短内容：

wenyan publish "# Hello Wenyan\n\n这是一篇测试文章"

Frontmatter 要求

建议在 Markdown 顶部包含 frontmatter：

---
title: 文章标题
cover: ./cover.jpg
author: 作者名称
source_url: https://example.com
---

字段说明：

字段	必填	说明
title	✅	文章标题
cover	❌	封面图片（本地路径或网络 URL）
author	❌	作者
source_url	❌	原文链接
type	❌	文章类型，设为 image 表示图片消息（小绿书）
image_list	❌	图片路径列表（小绿书专用，最多 20 张）
need_open_comment	❌	是否打开评论
only_fans_can_comment	❌	是否仅粉丝可评论

说明：

• 如果未指定 cover，将自动使用正文第一张图片作为封面
• cover 支持本地路径和网络 URL
• type 和 image_list 用于图片消息发布，详见下方

发布图片消息（小绿书）

图片消息以图片为主体，适合发布图集类内容。支持两种方式：

方式一：使用 type: image（推荐）

在 frontmatter 中设置 type: image，CLI 会自动从正文中提取所有图片：

---
title: 人勤春来早，读书正当时
type: image
---

![](./1.jpeg)
![](./2.jpeg)
![](./3.jpeg)
![](./4.jpeg)
![](./5.jpeg)

CLI 会自动：

1. 提取正文中所有图片路径
2. 将路径注入 image_list
3. 从正文中移除图片引用

方式二：手动指定 image_list

直接在 frontmatter 中列出图片路径：

---
title: 人勤春来早，读书正当时
image_list:
  - ./1.jpeg
  - ./2.jpeg
  - ./3.jpeg
  - ./4.jpeg
  - ./5.jpeg
---

说明

• image_list 最多 20 张图片
• 第一张图片自动作为封面（也可通过 cover 字段指定）
• 图片消息不会应用主题样式，保持图片为主体
• 支持本地路径和网络 URL

图片处理机制

CLI 自动识别并上传 Markdown 中的图片。

支持以下路径类型：

类型	示例
本地绝对路径	/Users/lei/image.png
相对路径	./assets/image.png
网络图片	https://example.com/image.png

示例：

![](./image.png)

<img src="./image2.png" />

CLI 将自动：

• 上传图片到微信素材库
• 替换为微信公众号可访问 URL

无需手动上传图片。

使用远程 Server 发布

当本地环境无法直接访问微信公众号 API（如 IP 不在白名单中）时，可使用远程 Server。

wenyan publish \
  -f article.md \
  --server https://api.example.com \
  --api-key your-api-key

工作流程：

1. CLI 读取 Markdown 和图片
2. 上传到 Wenyan Server
3. Server 调用微信公众号 API
4. 返回发布结果

Server 模式同样支持小绿书发布。CLI 会自动检测 image_list，将图片上传到 Server 并路由到图片消息发布接口。

适用于：

• CI/CD
• 云服务器
• 动态 IP 环境
• 团队协作

参数说明

参数	简写	说明	必填	默认值
--file	-f	Markdown 文件路径	否¹	-
--theme	-t	排版主题	否	default
--highlight	-h	代码高亮主题	否	solarized-light
--custom-theme	-c	自定义主题 CSS（本地或 URL）	否	-
--no-mac-style	-	禁用代码块 Mac 风格	否	启用
--no-footnote	-	禁用脚注转换	否	启用
--app-id	-	需要发布的公众号 AppId	否	-
--server	-	Wenyan Server 地址	否	-
--api-key	-	Server API Key	否²	-
--proxy	-	代理服务器地址	否	-
--env-file	-	指定环境变量配置文件（如 .env.local）	否	-
--help	-	查看帮助	否	-

说明：

¹ 必须满足以下之一：

• 使用 --file
• 使用 stdin
• 直接传入 Markdown 内容

² 仅在指定 --server 时生效。

代理配置说明

--proxy 支持 HTTP/HTTPS/SOCKS4/SOCKS5 代理，也可通过环境变量配置，代理会作用于所有微信 API 调用与图片上传。

常用格式：

http://127.0.0.1:7890
https://127.0.0.1:7890
socks4://127.0.0.1:1080
socks5://127.0.0.1:1080

命令行使用：

wenyan publish -f article.md --proxy http://127.0.0.1:7890

环境变量（推荐）：

# Linux/Mac
export HTTP_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:1080

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"

带认证代理：

http://username:password@proxy-server:port

示例

使用主题发布

wenyan publish \
  -f article.md \
  -t lapis \
  --highlight monokai

使用自定义主题

wenyan publish \
  -f article.md \
  --custom-theme ./my-theme.css

关闭附加样式

wenyan publish \
  -f article.md \
  --no-mac-style \
  --no-footnote

发布图片消息（小绿书）

wenyan publish -f photos.md

其中 photos.md 内容：

---
title: 人勤春来早，读书正当时
type: image
---

![](./1.jpeg)
![](./2.jpeg)
![](./3.jpeg)

使用远程 Server

wenyan publish \
  -f article.md \
  --server https://api.wenyan.dev \
  --api-key your-api-key

使用管道发布

cat article.md | wenyan publish

使用指定 AppId 发布

wenyan publish \
  -f article.md \
  --app-id your-app-id \
  --server https://api.wenyan.dev \
  --api-key your-api-key

常见问题

图片上传失败

请检查：

• 图片路径是否正确
• 图片文件是否存在
• 图片格式是否支持（jpg、png、gif）

发布失败：invalid ip

说明当前机器 IP 未加入微信公众号白名单。

解决方法：

• 使用远程 Server 模式
• 或将当前 IP 加入微信公众号白名单

发布失败：invalid appid or secret

请检查环境变量中是否存在如下配置：

WECHAT_APP_ID
WECHAT_APP_SECRET

如果配置了多公众号发布，使用wenyan credential -l命令，查看凭据中是否正确配置了AppId和AppSecret。

相关命令

• wenyan render：仅渲染 HTML，不发布
• wenyan serve：启动 Server
• wenyan theme：管理主题
• wenyan credential：管理凭据