为 Markdown 插图
xianchou markdown images <file> 会分析 Markdown 内容,生成图片计划,并按章节插入图片。默认是 dry-run,不会写回原文。
Dry-run
xianchou markdown images ./article.md --count 3
写回文件
xianchou markdown images ./article.md --count 3 --write
指定资源目录
可以指定图片保存目录和写入 Markdown 的 URL 前缀:
xianchou markdown images ./docs/guide.md \
--assets-dir ./docs/assets \
--public-url-prefix ./assets \
--count 3 \
--write
CLI 会插入带标记的图片块:
<!-- xianchou:image title="章节标题" -->

该标记用于重复运行时更新已有图片,避免重复插入。
生成封面图
xianchou markdown images ./article.md \
--cover \
--count 3 \
--write
--cover 会额外生成封面图,并将 cover 和 coverAlt 写入 Markdown frontmatter。图片保存位置和链接前缀仍由 --assets-dir 与 --public-url-prefix 控制。
参数
| 参数 | 说明 |
|---|---|
<file> | 必填,Markdown 文件路径 |
--count <count> | 正文图片数量,默认 3 |
--cover | 生成并更新封面 |
--write | 写回 Markdown;不传则只输出结果 |
--assets-dir <dir> | 生成图片保存目录 |
--public-url-prefix <prefix> | 写入 Markdown 的 URL 前缀 |
--project-id <projectId> | 项目 ID |
--provider-id <providerId> | 生图 provider ID |
--model-id <modelId> | 生图 model ID |
--channel <channel> | 生图通道 |
--ratio <ratio> | 图片比例 |
--resolution <resolution> | 图片分辨率 |
--output-format <format> | 图片输出格式 |