Xiaohongshu Note Creation Skill

Usage Scenarios

• When users need to create Xiaohongshu notes
• When users need to convert provided materials into Xiaohongshu-style content
• When users need to generate beautiful image cards for publishing

Workflow

Step 1: Write Xiaohongshu Note Content

Title Requirements

• No more than 20 characters
• Eye-catching and curiosity-inducing
• Use numbers, questions, or exclamation marks to enhance appeal
• Examples: "5 Efficiency Tools to Double Your Productivity!", "Shocking! This Is the Right Way to Do It"

Body Requirements

• Use good formatting with clear paragraphs
• Add a small number of emojis to improve readability (1-2 per paragraph)
• Use short sentences and paragraphs
• Include SEO-friendly tags at the end (5-10 relevant tags)

Step 2: Generate Markdown Document

1. YAML front matter (cover information):

---
emoji: "🚀"           # Cover decorative emoji
title: "Main Title"        # Cover main title (no more than 15 characters)
subtitle: "Subtitle Copy"  # Cover subtitle (no more than 15 characters)
---

1. Markdown text content for rendering cards:
   • When the content to be rendered must be strictly split into separate images, use the

     ---

     separator to actively divide the body into multiple card paragraphs (control each paragraph to around 200 characters), and use the parameter

     -m separator

     when outputting images
   • When the content to be rendered does not require strict splitting, generate normal Markdown text and select pagination mode parameters as needed

---
emoji: "💡"
title: "5 Efficiency Tools to Boost Work Productivity"
subtitle: "Just copy this and become more efficient together"
---

# 📝 Tool 1: Notion

> All-in-one note-taking tool that supports multiple views like databases, kanban boards, calendars...

## Key Features

- Feature 1
- Feature 2

# ⚡ Tool 2: Raycast

## Reasons for Recommendation

- Reason 1
- Reason 2
- ……


# 🌈 Tool 3: Arc

A browser with a new concept, featuring sidebar tab management...

...

Step 3: Render Image Cards

python scripts/render_xhs.py <markdown_file> [options]

• Default output directory is the current working directory
• Generated images include: cover (cover.png) and body cards (card_1.png, card_2.png, ...)

Rendering Parameters (Python)

--output-dir

-o

--theme

-t

default

--mode

-m

separator

--width

-w

1080

--height

dynamic

1440

--max-height

dynamic

4320

--dpr

2

Layout Themes (

--theme

)

• default

  : Default minimalist light gray gradient background (

  #f3f3f3 -> #f9f9f9

  )

• playful-geometric

  : Playful geometric (Memphis) style

• neo-brutalism

  : Neo-brutalism style

• botanical

  : Botanical natural style

• professional

  : Professional business style

• retro

  : Retro nostalgic style

• terminal

  : Terminal command line style

• sketch

  : Hand-drawn sketch style

Pagination Modes (

--mode

)

• separator

  : Paginate by

  ---

  separators (suitable for content with manually controlled volume)

• auto-fit

  : Automatically scale text within fixed dimensions to avoid overflow/blank space (suitable for cover + single image with fixed dimensions)

• auto-split

  : Automatically split pages based on rendered height (suitable for long content where splitting does not affect reading)

• dynamic

  : Dynamically adjust image height based on content (Note: Maximum image height is 4320, not recommended for content with over 550 characters)

Common Examples

# 1) Default theme + manual separator pagination
python scripts/render_xhs.py content.md -m separator

# 2) Fixed 1080x1440, auto-scale text to fill the screen as much as possible
python scripts/render_xhs.py content.md -m auto-fit

# 3) Auto-split pagination (Recommended: for content with unstable length)
python scripts/render_xhs.py content.md -m auto-split

# 4) Dynamic height (Allows cards of different heights)
python scripts/render_xhs.py content.md -m dynamic --max-height 4320

# 5) Switch theme
python scripts/render_xhs.py content.md -t playful-geometric -m auto-split

Node.js Rendering (Optional)

node scripts/render_xhs.js content.md -t default -m separator

--output-dir/-o

--theme/-t

--mode/-m

--width/-w

--height

--max-height

--dpr

Step 4: Publish Xiaohongshu Notes (Optional)

python scripts/publish_xhs.py --title "Note Title" --desc "Note Description" --images card_1.png card_2.png cover.png

1. Configure Xiaohongshu Cookie:

XHS_COOKIE=your_cookie_string_here

1. How to obtain Cookie:
   • Log in to Xiaohongshu (https://www.xiaohongshu.com) in your browser
   • Open Developer Tools (F12)
   • Check the Cookie in the request header under the Network tab

Image Specifications

Cover Card

• Aspect ratio: 3:4 (Xiaohongshu recommended ratio)
• Base size: 1080×1440px
• Includes: Emoji decoration, main title, subtitle
• Style: Gradient background + rounded content area

Body Card

• Aspect ratio: 3:4
• Base size: 1080×1440px
• Supports: Titles, paragraphs, lists, quotes, code blocks, images
• Style: White card + gradient background border

Skill Resources

Script Files

• scripts/render_xhs.py

  - Python rendering script

• scripts/render_xhs.js

  - Node.js rendering script

• scripts/publish_xhs.py

  - Xiaohongshu publishing script

Resource Files

• assets/cover.html

  - Cover HTML template

• assets/card.html

  - Body card HTML template

• assets/styles.css

  - Shared stylesheet

Notes

1. Markdown files should be saved in the working directory, and rendered images are also saved in the working directory
2. The skill directory (

   md2Redbook/

   ) only stores scripts and templates, not user data
3. Image dimensions will be automatically adjusted based on content, but maintain a 3:4 aspect ratio
4. Cookies have an expiration date; you need to re-obtain them after expiration
5. The publishing function depends on the xhs library, which needs to be installed:

   pip install xhs