书架
把飞书文档变成网页:一次导入的全过程
工具与效率

把飞书文档变成网页:一次导入的全过程

从块结构到 Markdown,再到图片转存,记录我们踩过的坑。

慢慢读,不着急。
M
MSQ 编辑部
2026 年 11 月 5 日 · 约 1 分钟

为什么要导入

团队的文档大多写在飞书里。写的时候很方便,但想公开分享时,飞书的分享页并不适合长时间阅读:栏宽太宽,字体也没法调。

所以我们决定:飞书负责写,知识库负责读。

飞书文档的结构

飞书的新版文档(docx)由一个个「块」组成:标题、段落、列表、代码、图片、表格,每一种都是一个块,块之间有父子关系。

导入的第一步,是把这棵块树完整地拉下来。

转成 Markdown

块树转 Markdown 的工作,我们没有自己写,而是用了开源的 feishu-docx。它覆盖了绝大部分块类型,剩下的少数几种(比如多维表格)我们在导入时给出提示。

图片转存

飞书返回的图片地址会过期,必须在导入时下载下来,再上传到我们自己的对象存储,最后替换掉 Markdown 里的链接。

下一步

导入只是一半。另一半是反过来:把知识库里的文章同步回飞书。这部分我们下一篇再讲。

17
读完了?说两句吧。

评论 0 条

还没有评论,来说第一句吧。