为什么要导入
团队的文档大多写在飞书里。写的时候很方便,但想公开分享时,飞书的分享页并不适合长时间阅读:栏宽太宽,字体也没法调。
所以我们决定:飞书负责写,知识库负责读。
飞书文档的结构
飞书的新版文档(docx)由一个个「块」组成:标题、段落、列表、代码、图片、表格,每一种都是一个块,块之间有父子关系。
导入的第一步,是把这棵块树完整地拉下来。
转成 Markdown
块树转 Markdown 的工作,我们没有自己写,而是用了开源的 feishu-docx。它覆盖了绝大部分块类型,剩下的少数几种(比如多维表格)我们在导入时给出提示。
图片转存
飞书返回的图片地址会过期,必须在导入时下载下来,再上传到我们自己的对象存储,最后替换掉 Markdown 里的链接。
下一步
导入只是一半。另一半是反过来:把知识库里的文章同步回飞书。这部分我们下一篇再讲。
评论 0 条
还没有评论,来说第一句吧。