Feishu2md icon

Feishu2md

下载飞书文档为 Markdown(使用 feishu2md CLI)

Overview

This node downloads documents from Feishu (a collaboration platform) as Markdown files using the feishu2md CLI tool. It supports downloading single documents, batch folders, or knowledge base wikis from Feishu's new document URLs with link sharing enabled. The node can output the downloaded content either as individual Markdown files or as a ZIP archive. It is useful for automating the extraction and conversion of Feishu documents into Markdown format for further processing or storage.

Use Case Examples

  1. Downloading a single Feishu document as multiple Markdown files for content migration.
  2. Batch downloading a folder of documents from Feishu cloud drive as a ZIP archive for backup.
  3. Exporting a Feishu knowledge base wiki as Markdown files for offline access or integration with other tools.

Properties

Name Meaning
文档 URL The URL of the Feishu new version document to download (requires link sharing enabled). This is a required input.
输出模式 Output mode specifying whether to output each Markdown file individually or as a ZIP archive.
下载类型 Manual selection of download type: single document (Docx), batch folder, or knowledge base wiki. Defaults to single document.
文件名前缀 Optional prefix to add to the output file names.

Output

Binary

Binary output contains the downloaded Markdown files or ZIP archive data.

JSON

  • fileName - The name of the output file when outputting individual Markdown files or static assets.

Dependencies

  • feishuApi credential (providing App ID and App Secret)
  • feishu2md CLI tool executable

Troubleshooting

  • Ensure the Feishu document URL is provided and accessible with link sharing enabled.
  • Verify that Feishu API credentials (App ID and App Secret) are correctly configured.
  • Make sure the feishu2md CLI tool is installed and accessible in the system PATH or specified locations.
  • Check file system permissions for reading/writing temporary files and directories.
  • If no Markdown files are found, the node outputs a ZIP archive containing all files instead.

Discussion