跳到主要内容

为 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="章节标题" -->
![章节标题配图](./assets/guide-01.webp)

该标记用于重复运行时更新已有图片,避免重复插入。

生成封面图

xianchou markdown images ./article.md \
--cover \
--count 3 \
--write

--cover 会额外生成封面图,并将 covercoverAlt 写入 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>图片输出格式