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

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

4. Validate output: 检查生成的 Markdown 格式和内容完整性
5. 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