Xiaohongshu Text Image

Read references/content-patterns.md when the source material is long, repetitive, or badly structured.

Choose a layout deliberately

Use one pattern consistently across a set:

• cover: large title, optional subtitle, highlight chips, footer CTA.
• slide: tag or step label, smaller title, 3-5 bullet lines, optional footer.
• quote: oversized statement with minimal decoration.
• checklist: title plus stacked checklist items and a short CTA.

Read references/visual-spec.md when you need spacing, hierarchy, safe-margin, or ratio guidance.

Render with bundled resources

Use scripts/render_text_card_svg.py for deterministic output.

• Feed the script a single-card JSON spec or a multi-card series spec.
• Start from assets/themes/warm-note.json or assets/themes/sharp-contrast.json.
• Duplicate assets/specs/example-cover.json or assets/specs/example-carousel.json instead of inventing the schema from scratch.
• Use --format svg for editable vector output.
• Use --format png or --format jpg for ready-to-post assets.
• Use --scale 2 when you want 2x raster output.

Raster export uses a bundled macOS AppKit renderer through xcrun swift. It keeps the original canvas size and avoids the text clipping issues that Quick Look thumbnails introduced.

Example:

python3 scripts/render_text_card_svg.py \
  --spec assets/specs/example-carousel.json \
  --theme assets/themes/warm-note.json \
  --format png \
  --output-dir /tmp/xhs-demo

Check the result before handoff

Inspect every generated page:

• The hook must be readable within 2 seconds.
• No page should contain more than one core message.
• Accent color should appear only on the hook, highlights, or CTA.
• Text must stay inside safe margins with visible breathing room.
• The series should look like one system, not unrelated posters.

Use the bundled files

• Use scripts/render_text_card_svg.py to generate SVG, PNG, or JPG cards from JSON specs.
• Read references/content-patterns.md for headline, hook, and carousel-copy heuristics.
• Read references/visual-spec.md for ratio, spacing, hierarchy, and readability rules.
• Start from the sample theme/spec assets and then adjust only what the task actually needs.