Skills feishu-doc-converter

install

source · Clone the upstream repo

git clone https://github.com/wulaosiji/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/wulaosiji/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/feishu-doc-converter" ~/.claude/skills/wulaosiji-skills-feishu-doc-converter && rm -rf "$T"

manifest: feishu-doc-converter/SKILL.md

source content

Feishu Document Converter

飞书文档格式转换技能 — 支持文档与 Markdown 互转，以及外部链接转 Markdown。

When to Use

需要将飞书云文档导出为 Markdown 时
需要将微信公众号文章等外部链接转为 Markdown 时
需要批量转换多个文档或链接时
需要将知识库内容导出以便迁移或备份时

Do NOT use this skill if

需要创建新的飞书文档 → 使用
```
feishu-doc-orchestrator
```
只需要读取文档内容而不转换格式 → 使用
```
feishu-doc
```
需要下载原始 PDF 文件 → 使用
```
feishu-pdf-downloader
```

Typical Trigger Phrases

"把这个飞书文档转成 Markdown"
"导出知识库文档为 MD"
"Convert this Feishu doc to markdown"
"抓取微信文章并转成 Markdown"

Workflow

Ask for inputs: 确认源内容类型（飞书文档 URL / 外部链接 / 本地文件）和输出路径
Choose method:
- 飞书云盘文档 →
```
doc_to_md()
```
  或命令行
```
convert.py doc
```
- 知识库文档 →
```
url_to_md()
```
  （Browser 方式）
- 外部链接（微信公众号等） →
```
url_to_md()
```

Run conversion:

# 文档转 MD
python3 skills/feishu-doc-converter/scripts/convert.py doc "https://feishu.cn/docx/xxx" output.md

# 链接转 MD
python3 skills/feishu-doc-converter/scripts/convert.py url "https://mp.weixin.qq.com/s/xxx" output.md

Validate output: 检查生成的 Markdown 格式和内容完整性
Return result: 返回输出文件路径

Guardrails

飞书云盘文档推荐使用 API 方式（
```
doc_to_md
```
），速度快且无需登录
知识库文档统一使用
```
url_to_md
```
（Browser 方式），因为知识库权限模型与云盘不同
微信文章抓取复用
```
wechat-article-fetcher
```
逻辑
批量转换时建议逐个处理，避免并发导致封号或限流

Supported Sources

平台	状态	说明
飞书云盘文档	✅ 支持	API 方式（ `doc_to_md` ）或 Browser 方式（ `url_to_md` ）
飞书知识库文档	✅ 支持	Browser 方式（ `url_to_md` ，推荐）
外部知识库	✅ 支持	Browser 方式（ `url_to_md` ）
微信公众号	✅ 支持	API 方式（ `url_to_md` ）
知乎	🚧 待实现	-
普通网页	🚧 待实现	-

Python API

from skills.feishu_doc_converter import doc_to_md, url_to_md

# 云盘文档转 Markdown
md_content = doc_to_md("docx/UD18dxyZfoo4uRx4cTNchIc8nBe")
md_content = doc_to_md("https://feishu.cn/docx/xxx")

# 知识库文档
md_content = doc_to_md("https://uniquecapital.feishu.cn/wiki/xxx")

# 链接转 Markdown
md_content = url_to_md("https://mp.weixin.qq.com/s/xxx")

Related Skills

feishu-doc-orchestrator - 创建飞书文档
feishu-wiki-orchestrator - 知识库文档创建
feishu-doc - 只读读取飞书文档
feishu-pdf-downloader - 下载飞书文件

About

Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai