飞书文档转markdown(feishu2md)

风流少年2026-01-27 10:01

https://github.com/Wsine/feishu2md 基于 Go 的飞书文档导出工具，可下载 DOCX 文档为 Markdown，并支持自动获取/刷新 user_access_token。工具提供传统 CLI 与 STDIO（MCP 兼容）两种交互方式。

一：获取App ID 和 App Secret

使用个人账号进入飞书开发者平台(https://open.feishu.cn/app)，创建企业自建应用。创建企业时要么使用个人账号，要么使用测试企业，不要使用公司的账号(需要审核)。
添加权限，打开权限管理，开通以下必要的权限（注意：权限类型必须是用户身份, 个别类型同时也要开通应用身份），简单起见全选全部开通：
- docx:document:readonly
- docs:document.media:download
- docs:document.comment:read
- docs:document.media:download
- board:whiteboard:node:read
- wiki:wiki
- wiki:wiki:readonly（若需要 wiki 下载）
- wiki:node:rea
- offline_access（若希望自动刷新 access token）

用户身份开通全部权限

应用身份还要开通如下权限：

打开凭证与基础信息，获取 App ID 和 App Secret

二：安装工具

下载Release编译后的程序如feishu2md-v2.4.5-windows-amd64.zip https://github.com/Wsine/feishu2md/releases解压后feishu2md.exe，并为此配置到环境变量中。

将feishu2md.exe放入到D:\Software\tools，并将该目录放入到PATH中。

三：使用工具

shell 复制代码

	# 配置和授权
	feishu2md config --appId <APP_ID> --appSecret <APP_SECRET>
	
	# 直接下载文档：复制链接（互联网获得链接的人）
	feishu2md download --output <输出目录> https://mi.feishu.cn/wiki/Apb6wzQxxxx

复制链接（互联网获得链接的人）

这里没有流程图。

https://blog.51cto.com/u_16861625/11287764