xhs-article-to-image

name	xhs-article-to-image
description	Convert markdown articles into XiaoHongShu (小红书) style portrait image cards (1080×1440 PNGs) for social distribution.
version	1.0.0
category	content
skillType	claude-skill
tags	["content","image","xhs","marketing","playwright"]
execution	{"type":"script","script":{"file":"execute.sh","interpreter":"bash","timeoutMs":60000}}

xhs-article-to-image

Convert markdown articles into XiaoHongShu (小红书) style image cards.

Description

Generates multiple PNG images (1080×1440, 3:4 portrait ratio) from markdown article content, styled in the popular XiaoHongShu magazine-layout format: bold titles, clean white backgrounds, structured paragraphs with visual hierarchy.

Usage

bash execute.sh '{"content":"# Title\n\nArticle body...","outputDir":"/tmp/xhs-output"}'

Or from a file:

bash execute.sh '{"sourceFile":"/path/to/article.md","outputDir":"/tmp/xhs-output"}'

Parameters

Parameter	Required	Default	Description
content	Yes*	-	Markdown article content (required if no sourceFile)
sourceFile	Yes*	-	Path to markdown file (required if no content)
outputDir	Yes	-	Directory to write PNG images to
title	No	auto	Override the article title (auto-extracts from first H1)
author	No	""	Author name shown at bottom of pages
accentColor	No	"#1a1a1a"	Accent color for decorative elements
bgColor	No	"#fafaf8"	Background color
maxCharsPerPage	No	350	Approximate characters per page before splitting
coverImage	No	""	URL or path to image for the cover page

Output

• Multiple PNG files: page-01.png, page-02.png, etc.
• First page is the title/cover page
• Returns JSON with file paths and metadata

Dependencies

• Node.js 18+
• Playwright (chromium)

Style Features

• 3:4 portrait ratio (1080×1440px) optimized for XHS
• Bold sans-serif Chinese/English typography (Noto Sans SC)
• Clean white/cream background with subtle decorative elements
• Magazine-style paragraph layout with visual breathing room
• Page numbering (current/total)
• Optional author attribution