Back to search
xhs-article-to-images
SkillGitHub
Agent-assisted Markdown article to Xiaohongshu image cards workflow
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/bozhoudev--xhs-article-to-images)HTML
<a href="/listings/bozhoudev--xhs-article-to-images"><img src="/api/listings/bozhoudev--xhs-article-to-images/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/bozhouDev/xhs-article-to-images.git cd xhs-article-to-images npm install npx playwright install chromium
作为 Codex / Claude skill 使用时,把仓库链接到你的 skills 目录:
ln -s "$(pwd)" ~/.codex/skills/xhs-article-to-images # 或: ln -s "$(pwd)" ~/.claude/skills/xhs-article-to-images
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 108 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: xhs-article-to-images
- description: 把 Markdown 长文转成小红书 3:4(1080×1440)图片组的 Agent skill。内置五套设计皮肤(E 雅刊·默认 / A 暖杏奶咖 / B 雾松青 / C 黛墨描金 / D 夜读鎏金)+ 女性向三主题(F 粉色王国 / G 乙游夜境 / H 吉卜力)× 多种页型;Agent 负责读文章、拆页和填 HTML,Playwright 渲染器负责逐张截图导出 PNG。当用户说"长文转图片"、"小红书长图"、"把这篇文章做成小红书图文/图片/卡片"、"文章转图片"、"用我的设计稿排版"、"转成 3:4 图组"、想要"女性向/少女风/粉色/乙游风/吉卜力风"排版时使用;用户给了一篇文章并提到发小红书时也应使用。
- ---
- # 小红书长文转图片
- 把一篇 Markdown 文章(含图片)转成一组小红书 3:4 卡片图。流水线:**读文章 → 选皮肤 → 拆页排版成 HTML → Playwright 截图 → 交付 PNG**。
- **默认目标:全文重排版**——把文章完整转成好看的图文卡片,不是 8 页精华摘要。主力页型是**正文**;段落有图就用**图文**;页型按需选用,不为凑花样硬塞金句/对比/清单页。
- 这个 skill 使用**固定的五套皮肤 + 女性向三主题模板**,不重新设计版式,目标是稳定复刻设计稿的样子。用户提到"皮肤/设计稿"或想要暖杏、雾松、黛墨、夜读、雅刊、粉色、乙游、吉卜力这类风格时用本 skill。
- ## 设计系统一览
- - 卡片基准 **1080 × 1440(3:4)**,皮肤与页型全部由 `assets/styles.css`(A/B/C 三套皮肤)、`assets/styles-d.css`(D 独立体系)、`assets/styles-e.css`(E 独立体系)、`assets/styles-fem.css`(女性向三主题独立体系)定义
- - 五套设计皮肤:**E 雅刊(默认)**(暖白纸 + Newsreader 高对比衬线,作品集编辑感,封面需一张配图)/ **A 暖杏奶咖**(暖调爆款)/ **B 雾松青**(清爽治愈,封面需 16:9 配图)/ **C 黛墨描金**(编辑感)/ **D 夜读鎏金**(深墨鎏金,惊艳向)
- - 女性向三主题(`femcard` 体系,共用一套骨架,换主题改 `t-pink/t-otome/t-ghibli` 类名 + 同步替换卡内 `.fem-deco` 装饰块):**F 粉色王国**(童话甜粉,彩虹+城堡+云朵手绘装饰,圆体标题)/ **G 乙游夜境**(暗黑浪漫深色,银紫光边框+罗马环+月+蝴蝶,高对比衬线)/ **H 吉卜力**(治愈自然,太阳+胖云+飞鸟+山丘,清新衬线)。女性向主题自带封面横幅图槽与 16:9 图文图槽
- - 基础页型:封面、正文、清单、图文混排(16:9 图槽)、结尾号召;**E 与女性向三主题另有可选页型**:大字陈述(statement)、要点正文(points / idea)、三观对比(views)——只在内容天然适合时用,**不是每篇必用**
- - A/B/C 共用一套 HTML 骨架,换肤只改 `skin-a/b/c` 类名;**D 用 `dcard`、E 用 `ecard`、女性向三主题用 `femcard` 独立类名体系,四套体系绝不混排**
- - 完整 HTML 骨架在 `assets/template.html`,所有页型都有现成可拷的示例块
- ## 工作流
- ### 1. 输入确认
- 需要:文章路径(Markdown)。可选:皮肤指定、品牌区文案、页数偏好。信息够就直接开工,不要追问。
- ### 2. 读文章 + 拆页规划
- 读 `references/content-mapping.md`(皮肤选择标准、页型容量上限、文案改写要求都在里面),然后产出内部页计划。**用户不指定皮肤时默认用 E 雅刊**,只有用户点名其他皮肤、或明确让你自由挑选时才换:
- ```text
- 皮肤:E 雅刊(默认)
- P1 cover 钩子标题 + 导语
- P2 body §1 为什么选 Obsidian(第 1 页)
- P3 body §1 续(装不下就拆页)
- P4 media 下载安装截图
- P5 body 新建仓库 + git clone
- P6 media GitHub 创建仓库截图
- ...
- Pn body 最后一节
- Pn+1 ending (可选)CTA
- ```
- 按文章 **H2/H3 顺序**拆页;**正文为主,有图用图文**;超容量拆页,**不删内容**。页数通常 10–18(小红书上限 18)。用户说「摘要版 / N 页以内」才做压缩。开工前用一两句话说明皮肤和预计页数即可。
- ### 3. 建任务文件夹 + 排版
- 在当前项目中为每篇文章建立一个任务文件夹,推荐命名为 `imgs-{标题}/`:
- ```
- imgs-Agent记忆/
- ├── index.html ← 从 template.html 拷贝骨架后填内容
- ├── styles.css ← 从 skill assets/ 拷贝
- ├── styles-d.css ← 从 skill assets/ 拷贝
- ├── styles-e.css ← 从 skill assets/ 拷贝
- ├── styles-fem.css ← 从 skill assets/ 拷贝(女性向三主题)
- ├── assets/ ← 文章配图、封面图;并拷入 assets/avatar.png(品牌头像)
- └── output/ ← 渲染产物 PNG(最终交付物)
- ```
- HTML/CSS 是工程中间产物:发布后只需保留 `output/` 里的 PNG,index.html、两个 CSS 和 assets 可以删掉(用户说"发布了/清理一下"时再删,不要主动删)。
- 排版要点:
- - 把四个 CSS(`styles.css`、`styles-d.css`、`styles-e.css`、`styles-fem.css`)和 `template.html` 拷进任务文件夹,把 template 改名 `index.html`,删掉用不到的示例卡,留下的卡按页计划填入真实内容
- - 每张卡的 id 按顺序命名:`xhs-01`、`xhs-02`…(渲染脚本按 id 命名 PNG)
- - 严格遵守 `content-mapping.md` 的每页容量上限,超了就**拆页**,**禁止删内容凑页**,**不许缩字号**
- - 文章里的图片拷贝/下载到任务 `assets/`,HTML 用相对路径引用
- ### 4. 配图处理
- - 文章自带图优先,放进图文混排页
- - 皮肤 E 的封面底部需要一张横幅配图(约 2.6:1 宽条裁切)、皮肤 B 的封面需要一张 16:9 横图:文章没有合适的就按 `content-mapping.md` 第五节的三选一流程(用户上传 / 网图 / AI 生成)处理一次
- - 如需 AI 生成配图,生成图只作为排版中间产物,存任务 `assets/` 即可
- ### 5. 渲染截图
- ```bash
- npx xhs-render <任务目录>
- # 或在本仓库根目录执行:
- node scripts/render.cjs <任务目录>
- ```
- 脚本会打开 `index.html`,等字体就绪后把所有 `.card` / `.dcard` / `.ecard` / `.femcard` 节点按 id 逐张导出到 `output/`,并打印每张实际尺寸(应为 1080×1440)。需要 2 倍清晰度加 `--scale 2`。
- ### 6. 自检 + 交付
- 渲染完先自己用 Read 工具看一遍每张 PNG,检查:
- - 文字是否溢出卡片、压到品牌区或贴边
- - 配图裁切是否裁掉了人脸 / 关键信息(需要时给 `<img>` 加 `object-position` 调整再渲)
- - 每页下半部分是否大面积空白(正文页应填满;图文页空白可能来自大图,但不应是因为删光了字)
- - 页码、总页数是否对得上
- 有问题改 HTML 重渲,没问题再交付。交付时给出:任务文件夹路径、每张图的绝对路径、皮肤和页数说明、网图来源(如有)。
- 如项目有自己的内容管理约定,可以把任务目录路径、输出 PNG 路径和发布文案记录回对应笔记或 issue。
- ## 禁忌
- - 不混皮肤:一组图只用一套皮肤;A/B/C 的 `card`、D 的 `dcard`、E 的 `ecard`、女性向三主题的 `femcard` 四套类名体系不互换;女性向三主题之间也只能选一个(t-pink / t-otome / t-ghibli)
- - 不发明新版式、新配色:只用四份 CSS 里已有的类,需要微调也只在任务文件夹的 index.html 里加内联样式,**不改 skill assets 里的 CSS**
- - 全文模式下正文忠实于原文结构,只做断行和轻度润色;封面标题可写钩子。只有用户要「摘要版」时才大幅压缩
- - 不缩小字号塞内容,不让文字溢出或贴边
- - 不在图片里放使用说明、快捷键提示等与内容无关的文字
README.md · README · 145 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # xhs-article-to-images
- 把 Markdown 长文转成小红书 3:4 图片组的 Agent skill。
- 它不是传统的全自动 Markdown parser。推荐用法是:让 Codex / Claude 这类 Agent 读文章、按规则拆页、填入 HTML 模板,再用内置 Playwright 渲染器逐张导出 PNG。
- ## 效果预览
- <table>
- <tr>
- <td><img src="preview/output/preview-e.png" width="180" alt="E 雅刊封面"></td>
- <td><img src="preview/output/preview-e-body.png" width="180" alt="E 雅刊正文页"></td>
- <td><img src="preview/output/preview-a.png" width="180" alt="A 暖杏奶咖"></td>
- </tr>
- <tr>
- <td><img src="preview/output/preview-b.png" width="180" alt="B 雾松青"></td>
- <td><img src="preview/output/preview-c.png" width="180" alt="C 黛墨描金"></td>
- <td><img src="preview/output/preview-d.png" width="180" alt="D 夜读鎏金"></td>
- </tr>
- <tr>
- <td><img src="preview/output/preview-f.png" width="180" alt="F 粉色王国"></td>
- <td><img src="preview/output/preview-g.png" width="180" alt="G 乙游夜境"></td>
- <td><img src="preview/output/preview-h.png" width="180" alt="H 吉卜力"></td>
- </tr>
- </table>
- ## 能做什么
- - 输出 1080 x 1440 PNG,适合小红书 3:4 图文。
- - 内置五套设计皮肤:E 雅刊(默认)、A 暖杏奶咖、B 雾松青、C 黛墨描金、D 夜读鎏金。
- - 外加女性向三主题:F 粉色王国(童话甜粉)、G 乙游夜境(暗黑浪漫)、H 吉卜力(治愈自然),共用一套 `femcard` 骨架、换类名即换主题。
- - 支持封面、正文、图文混排、清单、金句、大字陈述、要点正文、三观对比、结尾等页型。
- - 默认走全文重排版:正文为主,有图用图文,超容量拆页,不把长文硬压成 8 页摘要。
- - 提供 `xhs-init` 初始化任务目录,`xhs-render` 渲染截图。
- ## 安装
- ```bash
- git clone https://github.com/bozhouDev/xhs-article-to-images.git
- cd xhs-article-to-images
- npm install
- npx playwright install chromium
- ```
- 作为 Codex / Claude skill 使用时,把仓库链接到你的 skills 目录:
- ```bash
- ln -s "$(pwd)" ~/.codex/skills/xhs-article-to-images
- # 或:
- ln -s "$(pwd)" ~/.claude/skills/xhs-article-to-images
- ```
- ## 快速使用
- 初始化一篇文章的任务目录:
- ```bash
- npm run init:task -- ./work/my-article
- ```
- 编辑 `./work/my-article/index.html`:保留需要的卡片,填入文章内容,把图片放进 `./work/my-article/assets/`。
- 渲染 PNG:
- ```bash
- npm run render -- ./work/my-article
- ```
- 输出文件会在:
- ```text
- ./work/my-article/output/
- ```
- 需要 2 倍清晰度:
- ```bash
- npm run render -- ./work/my-article --scale 2
- ```
- ## 预览图重渲
- ```bash
- npm run render:preview
- ```
- 这会重新生成 `preview/output/*.png`,README 中的效果图也会随之更新。
- ## 目录结构
- ```text
- .
- ├── SKILL.md # Agent 使用说明
- ├── assets/
- │ ├── template.html # 全量卡片模板
- │ ├── styles.css # A/B/C 皮肤
- │ ├── styles-d.css # D 夜读鎏金
- │ ├── styles-e.css # E 雅刊
- │ ├── styles-fem.css # 女性向三主题 F 粉色王国 / G 乙游夜境 / H 吉卜力
- │ ├── avatar.png # 示例头像,可替换
- │ ├── cover-hero.jpg # 示例封面图
- │ ├── media-1.jpg # 示例图文页图片
- │ └── social/ # 作者社媒二维码
- ├── references/
- │ └── content-mapping.md # 文章到卡片的拆页规则
- ├── scripts/
- │ ├── init-task.cjs # 初始化任务目录
- │ └── render.cjs # Playwright 截图导出
- └── preview/ # README 预览工程和输出图
- ```
- ## 品牌替换
- 默认模板里使用了“泊舟的AI思考”和示例头像。开源仓库保留它们作为可运行示例;正式使用时替换:
- - `assets/avatar.png`
- - HTML 里的品牌名、tagline 和页脚文案
- - 封面/图文页中的示例图片
- ## 开源状态
- 这个仓库已经移除了本地绝对路径和私有 skill 依赖;`.DS_Store`、`node_modules`、普通任务输出目录会被忽略。`preview/output/*.png` 特意保留,用于 README 展示最终效果。
- ## 关注作者
- 如果这个项目对你有帮助,也可以关注一下我的社媒账号。
- <table>
- <tr>
- <td align="center">
- <img src="assets/social/xiaohongshu.jpg" width="260" alt="泊舟的AI思考 小红书账号">
- <br>
- 小红书
- </td>
- <td align="center">
- <img src="assets/social/douyin.jpg" width="260" alt="泊舟的AI思考 抖音账号">
- <br>
- 抖音
- </td>
- </tr>
- </table>
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.