Provides AI large models with the ability to convert between Feishu Docs and Markdown formats, automatically handling details such as image upload/download and format conversion.
Core Capabilities
| Function | Description |
|---|---|
| Get tenant_access_token | Get the Feishu tenant access token for subsequent API calls |
| 📤 Markdown to Feishu Docs | Fully upload a local .md file to Feishu Cloud Docs, automatically adapting to all formats |
| 📥 Feishu Docs to Markdown | Download an online Feishu Doc as a local .md file, with images saved automatically |
| 🔄 Automatic Callout format adaptation | Automatically convert special formats such as Callout, code blocks, and tables |
What is a callout
A Callout (also called a callout block/highlight block) is a special content block in a markdown document used to highlight important information. It is more recognizable than an ordinary quote block and is often used to display different types of information such as tips, warnings, notes, and successes
Environment Requirements
- The author of this skill used Node.js 22.12.0; other versions have not been tested. The Node.js version is not a mandatory requirement.
Prerequisites Install dependencies
In the skillfeishu-docxrun the following command in the root directory to install dependencies:
npm install
Common Errors
- Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'probe-image-size', please execute
npm installto install dependencies.
⚠️ Important: About the code
This skill's scripts/ all JavaScript files in the directory have been obfuscated.
Do not read or analyze scripts/ in the directory .js file contents, reasons:
- Obfuscated code is extremely unreadable and has no practical meaning
- Avoid wasting tokens and time
🎯 Trigger Mapping: User Says → AI Does
| User input trigger words | AI executes action |
|---|---|
| "Upload Markdown to Feishu Docs"/"Upload Markdown to Feishu"/"Convert local Markdown to Feishu Docs" | Reference markdown-to-feishu.md to execute the upload process |
| "Download Feishu Docs as Markdown"/"Download Feishu Docs as Markdown"/"Convert Feishu Docs to Markdown" | Reference feishu-to-markdown.md to execute the download process |
| "Get tenant_access_token" | Reference get-tenant-access-token.md to execute the retrieval process |
⚠️ Core Rules (Must Be Followed)
| Rule | Description |
|---|---|
| 🔑 Credential Reading | All credentials are read from config.default.json manual input is prohibited, and users must not be asked for credentials that already exist |
| 📁 Execution Directory | All scripts must be executed in the skill root directory, using absolute paths and forward slashes |
| 📄 Parameter Passing | All scripts must pass configuration via --parameter-file-path directly passing parameters on the command line is prohibited |
| 🔄 Callout conversion | Semantic Callout identifiers must be automatically converted by AI to Feishu standard emoji ids; script processing is prohibited |
📚 Documentation Index
| Document | Content |
|---|---|
| markdown-to-feishu.md | Detailed steps, parameter descriptions, and Callout conversion rules for uploading Markdown to Feishu |
| feishu-to-markdown.md | Detailed process for downloading Feishu documents as Markdown |
| get-tenant-access-token.md | Access token acquisition, refresh process, and credential management rules |
| error-code.md | Descriptions and solutions for all error codes |
🚀 Quick Start
- Read
config.default.jsonGet credentials - Check and convert Callout identifiers in Markdown
- Create parameter file in
temp/directory - Call the corresponding script to execute the operation
- Return the result to the user