小红书笔记创作技能
这个技能用于创建专业的小红书笔记素材,包括内容撰写、图片卡片生成和笔记发布。
使用场景
- - 用户需要创建小红书笔记时
- 用户提供资料需要转化为小红书风格内容时
- 用户需要生成精美的图片卡片用于发布时
工作流程
第一步:撰写小红书笔记内容
根据用户需求和提供的资料,创作符合小红书风格的内容:
标题要求
- - 不超过 20 字
- 吸引眼球,制造好奇心
- 可使用数字、疑问句、感叹号增强吸引力
- 示例:「5个让效率翻倍的神器推荐!」「震惊!原来这样做才对」
正文要求
- - 使用良好的排版,段落清晰
- 点缀少量 Emoji 增加可读性(每段 1-2 个即可)
- 使用简短的句子和段落
- 结尾给出 SEO 友好的 Tags 标签(5-10 个相关标签)
第二步:生成 Markdown 文档
注意:这里生成的 Markdown 文档是用于渲染卡片的,必须专门生成,禁止直接使用上一步的笔记正文内容。
Markdown 文件,文件应包含:
- 1. YAML 头部元数据(封面信息):
CODEBLOCK0
- 2. 用于渲染卡片的 Markdown 文本内容:
- 当待渲染内容必须严格切分为独立的数张图片时,可使用
--- 分割线主动将正文分隔为多个卡片段落(每个段落文本控制在 200 字左右),输出图片时使用参数
-m separator
- 当待渲染内容无需严格分割,生成正常 Markdown 文本即可,跟下方分页模式参数规则按需选择
完整 Markdown 文档内容示例:
CODEBLOCK1
第三步:渲染图片卡片
将 Markdown 文档渲染为图片卡片。使用以下脚本渲染:
CODEBLOCK2
- - 默认输出目录为当前工作目录
- 生成的图片包括:封面(cover.png)和正文卡片(card1.png, card2.png, ...)
渲染参数(Python)
| 参数 | 简写 | 说明 | 默认值 |
|---|
| INLINECODE2 | INLINECODE3 | 输出目录 | 当前工作目录 |
| INLINECODE4 |
-t | 排版主题 |
default |
|
--mode |
-m | 分页模式 |
separator |
|
--width |
-w | 图片宽度 |
1080 |
|
--height | | 图片高度(
dynamic 下为最小高度) |
1440 |
|
--max-height | |
dynamic 最大高度 |
4320 |
|
--dpr | | 设备像素比(清晰度) |
2 |
排版主题(--theme)
- -
default:默认简约浅灰渐变背景(#f3f3f3 -> #f9f9f9) - INLINECODE24 :活泼几何(Memphis)
- INLINECODE25 :新粗野主义
- INLINECODE26 :植物园自然
- INLINECODE27 :专业商务
- INLINECODE28 :复古怀旧
- INLINECODE29 :终端命令行
- INLINECODE30 :手绘素描
分页模式(--mode)
- -
separator:按 --- 分隔符分页(适合内容已手动控量) - INLINECODE34 :固定尺寸下自动缩放文字,避免溢出/留白(适合封面+单张图片但尺寸固定的情况)
- INLINECODE35 :按渲染后高度自动切分分页(适合切分不影响阅读的长文内容)
- INLINECODE36 :根据内容动态调整图片高度(注意:图片最高 4320,字数超过 550 的不建使用此模式)
常用示例
CODEBLOCK3
Node.js 渲染(可选)
CODEBLOCK4
Node.js 参数与 Python 基本一致:--output-dir/-o、--theme/-t、--mode/-m、--width/-w、--height、--max-height、--dpr。
第四步:发布小红书笔记(可选)
使用发布脚本将生成的图片发布到小红书:
CODEBLOCK5
前置条件:
- 1. 需配置小红书 Cookie:
- 方式一:设置环境变量
XHS_COOKIE=your_cookie_string_here
- 方式二(推荐):从 memory 读取,执行
memory_search 检索
xhs-cookie,然后从
memory/xhs-cookie.md 获取
- 2. Cookie 获取方式(如需要重新获取):
- 在浏览器中登录小红书(https://www.xiaohongshu.com)
- 打开开发者工具(F12)
- 在 Network 标签中查看请求头的 Cookie
- 获取后保存到
memory/xhs-cookie.md 以便后续使用
图片规格说明
封面卡片
- - 尺寸比例:3:4(小红书推荐比例)
- 基准尺寸:1080×1440px
- 包含:Emoji 装饰、大标题、副标题
- 样式:渐变背景 + 圆角内容区
正文卡片
- - 尺寸比例:3:4
- 基准尺寸:1080×1440px
- 支持:标题、段落、列表、引用、代码块、图片
- 样式:白色卡片 + 渐变背景边框
技能资源
脚本文件
- -
scripts/render_xhs.py - Python 渲染脚本 - INLINECODE50 - Node.js 渲染脚本
- INLINECODE51 - 小红书发布脚本
资源文件
- -
assets/cover.html - 封面 HTML 模板 - INLINECODE53 - 正文卡片 HTML 模板
- INLINECODE54 - 共用样式表
注意事项
- 1. Markdown 文件应保存在工作目录,渲染后的图片也保存在工作目录
- 技能目录 (
md2Redbook/) 仅存放脚本和模板,不存放用户数据 - 图片尺寸会根据内容自动调整,但保持 3:4 比例
- Cookie 有有效期限制,过期后需要重新获取
- 发布功能依赖 xhs 库,需要安装: INLINECODE56
小红书笔记创作技能
这个技能用于创建专业的小红书笔记素材,包括内容撰写、图片卡片生成和笔记发布。
使用场景
- - 用户需要创建小红书笔记时
- 用户提供资料需要转化为小红书风格内容时
- 用户需要生成精美的图片卡片用于发布时
工作流程
第一步:撰写小红书笔记内容
根据用户需求和提供的资料,创作符合小红书风格的内容:
标题要求
- - 不超过 20 字
- 吸引眼球,制造好奇心
- 可使用数字、疑问句、感叹号增强吸引力
- 示例:「5个让效率翻倍的神器推荐!」「震惊!原来这样做才对」
正文要求
- - 使用良好的排版,段落清晰
- 点缀少量 Emoji 增加可读性(每段 1-2 个即可)
- 使用简短的句子和段落
- 结尾给出 SEO 友好的 Tags 标签(5-10 个相关标签)
第二步:生成 Markdown 文档
注意:这里生成的 Markdown 文档是用于渲染卡片的,必须专门生成,禁止直接使用上一步的笔记正文内容。
Markdown 文件,文件应包含:
- 1. YAML 头部元数据(封面信息):
yaml
emoji: 🚀 # 封面装饰 Emoji
title: 大标题 # 封面大标题(不超过15字)
subtitle: 副标题文案 # 封面副标题(不超过15字)
- 2. 用于渲染卡片的 Markdown 文本内容:
- 当待渲染内容必须严格切分为独立的数张图片时,可使用 --- 分割线主动将正文分隔为多个卡片段落(每个段落文本控制在 200 字左右),输出图片时使用参数-m separator
- 当待渲染内容无需严格分割,生成正常 Markdown 文本即可,跟下方分页模式参数规则按需选择
完整 Markdown 文档内容示例:
markdown
emoji: 💡
title: 5个效率神器让工作效率翻倍
subtitle: 对着抄作业就好了,一起变高效
📝 神器一:Notion
全能型笔记工具,支持数据库、看板、日历等多种视图...
特色功能
⚡ 神器二:Raycast
\\\
可使用代码块来增加渲染后图片的视觉丰富度
\\\
推荐原因
🌈 神器三:Arc
全新理念的浏览器,侧边栏标签管理...
...
第三步:渲染图片卡片
将 Markdown 文档渲染为图片卡片。使用以下脚本渲染:
bash
python scripts/renderxhs.py file> [options]
- - 默认输出目录为当前工作目录
- 生成的图片包括:封面(cover.png)和正文卡片(card1.png, card2.png, ...)
渲染参数(Python)
| 参数 | 简写 | 说明 | 默认值 |
|---|
| --output-dir | -o | 输出目录 | 当前工作目录 |
| --theme |
-t | 排版主题 | default |
| --mode | -m | 分页模式 | separator |
| --width | -w | 图片宽度 | 1080 |
| --height | | 图片高度(dynamic 下为最小高度) | 1440 |
| --max-height | | dynamic 最大高度 | 4320 |
| --dpr | | 设备像素比(清晰度) | 2 |
排版主题(--theme)
- - default:默认简约浅灰渐变背景(#f3f3f3 -> #f9f9f9)
- playful-geometric:活泼几何(Memphis)
- neo-brutalism:新粗野主义
- botanical:植物园自然
- professional:专业商务
- retro:复古怀旧
- terminal:终端命令行
- sketch:手绘素描
分页模式(--mode)
- - separator:按 --- 分隔符分页(适合内容已手动控量)
- auto-fit:固定尺寸下自动缩放文字,避免溢出/留白(适合封面+单张图片但尺寸固定的情况)
- auto-split:按渲染后高度自动切分分页(适合切分不影响阅读的长文内容)
- dynamic:根据内容动态调整图片高度(注意:图片最高 4320,字数超过 550 的不建使用此模式)
常用示例
bash
1) 默认主题 + 手动分隔分页
python scripts/render_xhs.py content.md -m separator
2) 固定 1080x1440,自动缩放文字,尽量填满画面
python scripts/render_xhs.py content.md -m auto-fit
3) 自动切分分页(推荐:内容长短不稳定)
python scripts/render_xhs.py content.md -m auto-split
4) 动态高度(允许不同高度卡片)
python scripts/render_xhs.py content.md -m dynamic --max-height 4320
5) 切换主题
python scripts/render_xhs.py content.md -t playful-geometric -m auto-split
Node.js 渲染(可选)
bash
node scripts/render_xhs.js content.md -t default -m separator
Node.js 参数与 Python 基本一致:--output-dir/-o、--theme/-t、--mode/-m、--width/-w、--height、--max-height、--dpr。
第四步:发布小红书笔记(可选)
使用发布脚本将生成的图片发布到小红书:
bash
python scripts/publishxhs.py --title 笔记标题 --desc 笔记描述 --images card1.png card_2.png cover.png
前置条件:
- 1. 需配置小红书 Cookie:
- 方式一:设置环境变量 XHS
COOKIE=yourcookie
stringhere
- 方式二(推荐):从 memory 读取,执行 memory_search 检索 xhs-cookie,然后从 memory/xhs-cookie.md 获取
- 2. Cookie 获取方式(如需要重新获取):
- 在浏览器中登录小红书(https://www.xiaohongshu.com)
- 打开开发者工具(F12)
- 在 Network 标签中查看请求头的 Cookie
- 获取后保存到 memory/xhs-cookie.md 以便后续使用
图片规格说明
封面卡片
- - 尺寸比例:3:4(小红书推荐比例)
- 基准尺寸:1080×1440px
- 包含:Emoji 装饰、大标题、副标题
- 样式:渐变背景 + 圆角内容区
正文卡片
- - 尺寸比例:3:4
- 基准尺寸:1080×1440px
- 支持:标题、段落、列表、引用、代码块、图片
- 样式:白色卡片 + 渐变背景边框
技能资源
脚本文件
- - scripts/renderxhs.py - Python 渲染脚本
- scripts/renderxhs.js - Node.js 渲染脚本
- scripts/publish_xhs.py - 小红书发布脚本
资源文件
- - assets/cover.html - 封面 HTML 模板
- assets/card.html - 正文卡片 HTML 模板
- assets/styles.css - 共用样式表
注意事项
- 1. Markdown 文件应保存在工作目录,渲染后的图片也保存在工作目录
- 技能目录 (md2Redbook/) 仅存放脚本和模板,不存放用户数据
- 图片尺寸会根据内容自动调整,但保持 3:4 比例
- Cookie 有有效期限制,过期后需要重新获取
- 发布功能依赖 xhs 库,需要安装:pip install xhs