飞书文档一键转Markdown终极指南：3分钟快速上手feishu2md

你是否需要将飞书文档转换为Markdown格式？feishu2md正是你需要的解决方案。这款基于Go语言开发的开源工具能够帮助你轻松地将飞书文档下载并转换为Markdown文件，无论是单个文档还是批量处理都能胜任。

✨ 功能亮点

• 一键转换：简单命令即可完成飞书文档到Markdown的转换
• 批量处理：支持文件夹和知识库文档的批量下载
• 跨平台支持：Windows、macOS、Linux全平台兼容
• 配置简单：只需几步配置即可开始使用

📋 安装方式对比

安装方式	优点	缺点	适合人群
源码编译	最新功能，可定制	需要Go环境	开发者
预编译二进制	开箱即用，简单快捷	功能可能不是最新	普通用户
Docker部署	环境隔离，易于管理	需要Docker知识	运维人员

🚀 安装配置步骤

方法一：源码编译安装（推荐开发者）

首先确保你的系统已安装Git和Go语言环境（建议Go 1.16以上版本）：

git clone https://gitcode.com/gh_mirrors/fe/feishu2md
cd feishu2md
make build

编译完成后，会在项目根目录生成可执行文件 feishu2md。

方法二：使用预编译二进制文件

对于不想编译的用户，可以直接使用预编译的二进制文件。根据你的操作系统选择对应的版本下载后，解压即可使用。

方法三：Docker方式部署

如果你熟悉Docker，可以使用以下命令快速启动：

docker run -it --rm -p 8080:8080 \
  -e FEISHU_APP_ID=你的应用ID \
  -e FEISHU_APP_SECRET=你的应用密钥 \
  -e GIN_MODE=release \
  wwwsine/feishu2md

启动后访问 http://localhost:8080 即可通过网页界面使用。

⚙️ 配置飞书应用凭据

无论选择哪种安装方式，都需要配置飞书应用凭据：

1. 创建或使用现有的飞书开发者应用
2. 开启文档读取等相关权限
3. 获取App ID和App Secret
4. 使用以下命令配置：

feishu2md config --appId 你的应用ID --appSecret 你的应用密钥

🎯 使用示例

下载单个文档

feishu2md dl "飞书文档链接"

批量下载文件夹文档

feishu2md dl --folder "飞书文件夹链接"

下载知识库文档

feishu2md dl --wiki "飞书知识库链接"

🔧 常见问题排查

权限错误

确保飞书应用已开启文档读取权限，并且用户有相应文档的访问权限。

配置错误

检查App ID和App Secret是否正确，配置文件通常位于用户主目录下的 .feishu2md.yaml。

网络问题

如果遇到网络连接问题，请检查网络设置或尝试使用代理。

版本兼容性

确保使用的feishu2md版本与飞书API版本兼容，建议使用最新版本。

💡 使用技巧

• 使用 -o 参数指定输出目录
• 使用 -f 参数强制覆盖已存在的文件
• 结合脚本实现定时批量下载任务

通过以上步骤，你应该已经成功安装并配置了feishu2md工具。现在开始享受飞书文档到Markdown的无缝转换体验吧！