Feishu document toolkit: download docs via API or convert exported Word to AI-friendly Markdown
Project description
feishu-wiki-md
飞书文档工具:通过 API 下载飞书文档 / 将飞书导出的 Word 转为 AI 友好的 Markdown。
功能
下载飞书文档 (dl)
- 通过飞书链接直接下载文档并转为 Markdown
- 支持普通文档和知识库 Wiki
- 自动下载文档中的图片
Word 转 Markdown (wm)
- 将飞书导出的 .docx 文件转为干净的 Markdown
- 支持标题、列表、表格、图片、超链接、行内格式
- AI 友好后处理:标题层级归一化、空白折叠、Word 元素清理
安装
# 一键运行(无需安装)
uvx feishu-wiki-md --help
# 或本地安装
uv tool install .
使用
1. 登录飞书
首次使用 dl 前需要登录(需要先在飞书开放平台创建应用):
feishu-wiki-md login
# 或指定 app 凭据
feishu-wiki-md login --app-id cli_xxx --app-secret xxx
2. 下载飞书文档
# 下载到当前目录
feishu-wiki-md dl https://xxx.feishu.cn/docx/ABC123
# 指定输出目录
feishu-wiki-md dl https://xxx.feishu.cn/wiki/XYZ456 -o ./docs/
3. Word 转 Markdown
# 转换单个文件(输出到同目录)
feishu-wiki-md wm 需求文档.docx
# 批量转换
feishu-wiki-md wm *.docx -o ./output/
输出规则
- 无图片:
需求文档.docx→需求文档.md - 有图片:
需求文档/ ├── index.md └── assets/ ├── image001.png └── image002.png
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
feishu_wiki_md-0.2.0.tar.gz
(21.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file feishu_wiki_md-0.2.0.tar.gz.
File metadata
- Download URL: feishu_wiki_md-0.2.0.tar.gz
- Upload date:
- Size: 21.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f1485cb43e1852ce55f751a4193aba8780f3dc2b1cff25fde268702296a8ac03
|
|
| MD5 |
ce97e0fae1de07cb265ca3c24c560fb7
|
|
| BLAKE2b-256 |
d1f9ced2898836f0ced63a049499833c80ac502674ffa44ec05453ee2d7f93ea
|
File details
Details for the file feishu_wiki_md-0.2.0-py3-none-any.whl.
File metadata
- Download URL: feishu_wiki_md-0.2.0-py3-none-any.whl
- Upload date:
- Size: 16.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
855678c0cfe97d773ce3c8258a2bf2514ba7ae80774de1a00ad2a2abaf2b9350
|
|
| MD5 |
a76058182800314141245034e686e1a8
|
|
| BLAKE2b-256 |
15fb0f27d65913f899514c2c15ca00805d5ca961b1939e3160823d0723a57a75
|