Skip to main content

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.3.0.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

feishu_wiki_md-0.3.0-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file feishu_wiki_md-0.3.0.tar.gz.

File metadata

  • Download URL: feishu_wiki_md-0.3.0.tar.gz
  • Upload date:
  • Size: 22.0 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

Hashes for feishu_wiki_md-0.3.0.tar.gz
Algorithm Hash digest
SHA256 7a05587007d2bdeb2ed702d3c9337edf533a9ea23590ccf53220fa6381863138
MD5 5030e88f1a6c465fc11272683c81106b
BLAKE2b-256 87f5f62164a6a5b44aefe8b44de4b2894c530340c3b6e3b805e44ebded0dedb2

See more details on using hashes here.

File details

Details for the file feishu_wiki_md-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: feishu_wiki_md-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 16.7 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

Hashes for feishu_wiki_md-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf4d81e6bd377a6016fa42469034985e7d82f604195e2b0932d732890d58028a
MD5 99153f7dffe7693e1813410660cc5bf1
BLAKE2b-256 cb346305bda2a233a285fff263e2352befbf6a2f23d6dcf4895bf0b11645d004

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page