xhs-longform-private-publisher

Convert Markdown articles with ordered images into private Xiaohongshu longform posts.

425|37|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill xhs-longform-private-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xhs-longform-private-publisher
Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/main/skills/full/xhs-longform-private-publisher
Command: npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill xhs-longform-private-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, playwright, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Moves an existing Markdown longform and its images into Xiaohongshu's longform editor without rewriting content, automating the repetitive, error-prone steps of manual copy-paste, image uploads, layout, and verification so authors can publish reliably as private posts.

Core Features & Use Cases

  • Lossless transfer: preserve original wording, heading structure, lists, code blocks and other Markdown semantics by converting parts to HTML before insertion.
  • Ordered image insertion: detect Markdown image placeholders, enforce image count policies, and upload images in the exact placeholder order.
  • One-click layout and private publish: automate the platform's "one-click layout" flow, set visibility to "仅自己可见" (private), and capture manager-page proof screenshots.
  • Validation and recoverability: payload validation, clear error messages for mismatched parts/images, retry strategies, and a run summary JSON for repeatable execution.
  • Use case: ideal when you have a finished Markdown article with a folder of images and want to publish it unchanged as a private Xiaohongshu longform while collecting evidence for review.

Quick Start

Convert your Markdown and ordered images into the publishing payload and run the publisher to post privately and collect screenshots for verification.

Frequently Asked Questions about xhs-longform-private-publisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically publish a Markdown article with images to Xiaohongshu longform posts?

To publish Markdown articles with images to Xiaohongshu longform posts, this automation converts Markdown to HTML, uploads ordered images via Playwright, applies one-click layout, and saves verification screenshots.

How does ordered image insertion work when publishing Markdown longforms to Xiaohongshu?

Ordered image insertion works by detecting Markdown image placeholders and uploading the accompanying images in the exact placeholder sequence using Playwright automation to ensure correct visual flow in the longform post.

Can I publish a Xiaohongshu longform post privately to review formatting before making it public?

Yes, you can publish privately. The automation enforces private visibility, setting the post to "仅自己可见" (private), and captures manager-page proof screenshots for your manual verification.

What happens if the number of images does not match the Markdown placeholders during Xiaohongshu publishing?

If image counts mismatch Markdown placeholders, the publishing process halts. Payload validation enforces that parts equal images plus one, returning clear error messages to ensure recoverability and prevent broken posts.

Does the original Markdown wording and structure remain unchanged when converting to Xiaohongshu longform?

Yes, original wording and structure remain unchanged. The process renders Markdown semantics, including headings, lists, and code blocks, directly to HTML for lossless insertion into the Xiaohongshu editor.

Do I need Playwright installed to automate Xiaohongshu private post publishing?

Yes, Playwright is required. It drives the browser automation needed to interact with the Xiaohongshu editor, upload images in order, apply one-click layout, and set private visibility.