rednote-content

Rednote (小红书) Content Creation

Platform Overview

Rednote (小红书) is a Chinese lifestyle and commerce platform. Content must feel native — authentic, conversational, and visually structured. Posts combine cover images with text notes. The algorithm favors engagement-driving formatting.

Content Categories

This plugin supports four post categories. Each has distinct style conventions:

1. 信息分享 (Information Sharing)

• Source: Content (articles, docs, product pages) provided via Notion link — can be in English or Chinese
• Process: Read source → if English, translate to natural Chinese; if Chinese, rewrite in Rednote style → condense into image-friendly length → generate images → reformat for Rednote
• Condensing step: Source content needs to be restructured for image cards. Extract ALL key points (not just 3-5 — long articles may have 8-10+). Each key point becomes one content page with a section title + body text. Aim for 150-200 Chinese characters per content page — include explanations, examples, data points, or context so each page feels substantive and 干货满满, not sparse. Use up to 10 content pages to ensure no important information is lost.
• Source attribution: If the source material has identifiable origin (author, publication, original title), mention it naturally in the post body — e.g., "这篇来自 XX 的文章「原文标题」..." or "XX 最近发布了一篇关于...". Use descriptive text, NOT URLs. This builds credibility and respects the original creator.
• Tone: Knowledgeable, sharing-oriented ("我发现了一个超好用的..." / "给大家分享一下...")
• Structure: Hook title → source attribution (if applicable) → key points in digestible chunks → personal takeaway
• Image style: Follow the "Image Generation" section below for cover and content page styles. The author name on all cover images must be: 碳基补完计划

2. 产品测评 (Product Reviews)

• Tone: Honest, detailed, personal experience ("用了一个月的真实感受")
• Structure: Product intro → pros/cons → usage scenarios → verdict + rating
• Include: Specific details (price, where to buy, usage duration)

3. 教程/攻略 (Tutorials & Guides)

• Tone: Helpful, step-by-step ("手把手教你...")
• Structure: Numbered steps → tips/warnings → results/outcome
• Format: Heavy use of emoji numbering (1️⃣ 2️⃣ 3️⃣) and section dividers

4. 品牌推广 (Brand Promotion)

• Tone: Professional yet approachable, value-driven
• Structure: Pain point → solution → features → call to action
• Balance: Provide genuine value while promoting — avoid feeling like an ad

Title Writing (标题)

Titles are critical for click-through. Follow these patterns:

Formulas that work on Rednote:

• 数字 + 痛点: "5个让你少走弯路的XX技巧"
• 反问/悬念: "为什么90%的人都不知道这个？"
• 身份共鸣: "打工人必看！XX的正确方式"
• 结果导向: "用了这个方法，效率提升300%"
• 对比: "以前 vs 现在，XX真的改变了我"

Rules:

• Keep titles under 20 Chinese characters when possible
• Use 【】for emphasis brackets, not《》
• Include 1-2 emoji in titles for visual pop
• Avoid clickbait that doesn't deliver — Rednote users punish this

Body Text Formatting

Structure

• Open with a hook (1-2 sentences max)
• Use line breaks liberally — dense paragraphs perform poorly
• Emoji as bullet points: ✅ ❌ 💡 ⭐ 📌 🔥
• Section dividers: ➖➖➖ or ·····
• Keep paragraphs to 2-3 lines max
• End with a question or call-to-engagement ("你们觉得呢？" / "评论区告诉我～")

Writing Style

• Conversational, first-person
• Mix of short and medium sentences
• Sprinkle in colloquial expressions (亲测、安利、种草、拔草、yyds)
• Avoid overly formal or academic Chinese
• Use 「」for quotes instead of ""

Emoji Usage

• 3-6 emoji per post (not per line)
• Use consistently as section markers
• Don't overdo — Rednote users prefer clean readability over emoji walls
• Match emoji to content mood (🌟 for highlights, ⚠️ for warnings, 💰 for prices)

Hashtags (话题标签)

• Place at the end of the post
• Use 5-10 hashtags
• Mix broad + niche: #好物分享 #实用工具 #效率提升 #[specific topic]
• Include trending tags when relevant
• Format: #标签名 (no spaces between # and text)
• Research current trending tags for the specific category

Image Generation

All post images (cover + content pages) are generated by gen_images.py as 1242×1660px PNGs. The script handles font detection, mixed CJK/Latin rendering, and all layout logic described below.

封面页 (Cover Page) Style

The cover image is divided into two distinct zones stacked vertically:

Upper zone (~60% of the image):

• A vibrant, abstract gradient background with flowing organic shapes — like a close-up of a colorful flower or watercolor bloom
• Color palette: warm oranges, pinks, magentas, purples, with accents of light blue and green — dreamy, soft-focus aesthetic
• In the center of this zone: a white rounded-rectangle pill/badge (with subtle shadow) containing the main topic keyword in black sans-serif text (e.g., a product name, technology term, or short phrase like "GPT-5.4 Thinking")
• The pill badge should be horizontally centered, vertically centered within the upper zone

Divider:

• A thin colorful gradient strip (2-4px) matching the upper zone colors separates the two zones

Lower zone (~40% of the image):

• Clean white/very light gray background
• Large bold black serif Chinese text as the main title, wrapping across 2-3 lines (font size ~72-80px equivalent at 1242×1660)
• The title should be left-aligned with generous left/right margins (~80-100px)
• Below the title: author credit line with a small vertical bar icon: 丨作者：碳基补完计划 in smaller gray/dark text (~36px)

Color values:

• Upper zone gradient: #FF9A56 (orange), #E87CBB (pink), #C77DBA (purple), #8CC5E8 (light blue), #A8D86C (green)
• Lower zone background: #FFFFFF or #FAFAFA
• Title text: #1A1A1A (near black)
• Author text: #666666 (medium gray)

内容页 (Content Page) Style

Each content page follows a clean, text-only, warm-toned card design:

Background:

• Warm beige/cream color: #F5E6D3 or #F2E0CC — a cozy, paper-like warmth
• Consistent across ALL content pages in a single post

Page number (top-left):

• Large serif or semi-serif numerals: 01, 02, 03, etc.
• Color: dark brown/terracotta #8B4513 or #7A3B10
• Font size: very large (~96-120px equivalent), bold weight
• Positioned at top-left with ~80px margin from edges

Section title:

• Bold dark brown text (#7A3B10), ~48-56px
• Often phrased as a question or bold statement
• Positioned below the page number with ~40px gap

Body text:

• Dark brown/terracotta color (#8B4513), ~36-42px, regular weight
• Conversational, readable style
• Line spacing: 1.6-1.8x for readability

Separators:

• Thin horizontal line in matching brown color between logical sections

Quotes:

• Slightly lighter brown/gray color (#A0785A), with Chinese quotation marks "..."
• Visually distinguished from regular body text

Key design principles:

• NO images, icons, or decorative elements on content pages — pure text layout
• NO emoji on content page images (emoji are only for the text post body, not the image cards)
• Typography hierarchy: page number (largest) → section title (bold, large) → body text (regular)
• Generous margins: ~80-100px on all sides
• Aim for ~150-200 Chinese characters per content page for rich, substantive content

Content Page Count

Number of content pages scales with source depth — prioritize completeness over brevity:

• Short post (1-3 key points): 2-3 content pages
• Medium post (4-6 key points): 4-6 content pages
• Long/detailed post (7+ points, tutorials, in-depth articles): 7-10 content pages
• Maximum 10 content pages (excluding cover). Do NOT drop key points to save pages.

gen_images.py Usage

Use ${CLAUDE_PLUGIN_ROOT}/scripts/gen_images.py to generate all images (cover + content pages).

Programmatic usage:

import sys, os
sys.path.insert(0, os.path.join(os.environ.get("CLAUDE_PLUGIN_ROOT", "."), "scripts"))
from gen_images import generate_post, PostConfig, ContentPage

config = PostConfig(
    title="封面标题",
    keyword="Badge Text",
    pages=[ContentPage(title=t, body=b) for t, b in page_data],
)
paths = generate_post(config, "./output")
# paths = ["./output/cover.png", "./output/page_01.png", ...]

CLI usage:

# post.json: {"title": "封面标题", "keyword": "Badge", "pages": [{"title": "...", "body": "..."}]}
python ${CLAUDE_PLUGIN_ROOT}/scripts/gen_images.py --config post.json --output ./output

Requirements:

• pip install Pillow --break-system-packages
• CJK font must exist on the system (Linux: install fonts-noto-cjk; macOS: PingFang built-in)
• Output: 1242×1660px PNGs

Quality Checklist

Before finalizing any Rednote post, verify:

• Title is catchy and under 20 characters
• Body uses proper line breaks and emoji formatting
• Tone matches the category (信息分享/测评/教程/推广)
• Chinese reads naturally — not machine-translated
• 5-10 relevant hashtags included
• Cover image is a real PNG file with correct dimensions (1242×1660) and matches the reference style
• Content page images are real PNG files covering all key sections
• Number of content pages matches the content depth
• Each content page is readable at a glance and not overcrowded
• Visual style is consistent across all images
• Author name 碳基补完计划 appears on the cover
• Ends with engagement prompt