feishu-doc-writer

Convert Markdown content into Feishu Block structures and write them to cloud documents.

65|9|Updated Feb 10, 2026

Search Tags:#markdown #concurrency #docx #blocks #feishu #document-writing #cloud-docs

Ready to run

npx skills add https://github.com/alextangson/feishu_skills --skill feishu-doc-writer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: feishu-doc-writer
Source: https://github.com/alextangson/feishu_skills/tree/main/feishu-doc-writer
Command: npx skills add https://github.com/alextangson/feishu_skills --skill feishu-doc-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Feishu document writing often requires converting Markdown into a structured block-based format compatible with Feishu Docs, while ensuring correct rendering and ordering.

Core Features & Use Cases

Converts Markdown to Feishu Block structures (page, heading, text, image, etc.) and writes to cloud docs.
Handles concurrency ordering to preserve block order during multi-step writes.
Use Case: Sync long-form articles or knowledge base content to Feishu Docs with consistent formatting.

Quick Start

Provide Markdown content to be converted and saved as a Feishu cloud document.

Frequently Asked Questions about feishu-doc-writer

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

FAQPage Schema

How do I convert Markdown to Feishu cloud documents?▼

To convert Markdown to Feishu cloud documents, this Skill transforms Markdown content into structured Feishu Block JSON and persists it directly using the Feishu Docx API. It ensures accurate block trees and strict ordering for long-form articles and knowledge bases.

How does Feishu document writing handle block ordering during concurrent writes?▼

Feishu document writing handles concurrency ordering by applying strict ordered writes via the Feishu Docx API. This concurrency control preserves the correct block tree sequence during multi-step writes, preventing structural misalignment in cloud docs and knowledge bases.

Can I sync long-form articles to Feishu Docs without formatting loss?▼

You can sync long-form articles to Feishu Docs without formatting loss by converting Markdown into compatible Feishu Block structures like pages, headings, and text. This process maintains consistent formatting across your knowledge base content during cloud document creation.

What is the best way to automate knowledge base creation in Feishu from existing Markdown files?▼

The best way to automate knowledge base creation in Feishu is to convert existing Markdown files into Feishu Block structures and write them to cloud documents. This method guarantees reliable block creation and proper ordering for accurate documentation rendering.

Does writing Feishu blocks via the Docx API require manual block tree management?▼

Writing Feishu blocks via the Docx API does not require manual block tree management because this Skill automatically handles Markdown conversion to block JSON and applies concurrency control for ordered writes to maintain accurate document structures.

When should I use a structured Feishu Block converter instead of direct text pasting for cloud docs?▼

You should use a structured Feishu Block converter instead of direct text pasting when you need accurate block trees, strict ordering, and reliable rendering for long-form articles or knowledge bases synced from Markdown content via the Feishu Docx API.