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
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.3.1.tar.gz
(22.1 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.3.1.tar.gz.
File metadata
- Download URL: feishu_wiki_md-0.3.1.tar.gz
- Upload date:
- Size: 22.1 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 |
c9b45317e765abab36e8bb7c790752f9890fa7e73e27ef2ff6614e486e675057
|
|
| MD5 |
8657ae8549d6ced1a4e168a706ddf7d0
|
|
| BLAKE2b-256 |
4c0656824fb1af1e7c274a11cfa5938f0617873a6bc0450f676230e1488c661a
|
File details
Details for the file feishu_wiki_md-0.3.1-py3-none-any.whl.
File metadata
- Download URL: feishu_wiki_md-0.3.1-py3-none-any.whl
- Upload date:
- Size: 16.9 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 |
bf40396bea8393d8f967e9e3d03ce767ec0b2c284c6844363253fc90ce2d31cc
|
|
| MD5 |
6675e50f4a210b63be5e72f6d3ada5c4
|
|
| BLAKE2b-256 |
b2a61323581bd295a46aa83244070c361ba0d073e0a985cefbdcbf2d68c4122d
|
