语雀支持跨知识库内容复用与结构联动,具体包括:一、添加外部链接实现导航跳转;二、嵌入其他知识库文档以同步正文内容;三、通过知识库分组进行逻辑归类;四、调用API实现程序化关联。

如果您希望在语雀中实现跨知识库的内容复用或结构联动,例如将一个知识库中的文档作为引用嵌入到另一个知识库中,或建立文档间的导航关系,则需通过语雀提供的“外部链接”与“知识库嵌入”机制完成关联。以下是具体操作方法:
一、添加外部链接至其他知识库
该方法适用于在当前知识库的文档中插入指向其他知识库(含他人公开知识库或本团队内其他知识库)的可点击链接,便于读者跳转查阅。链接本身不同步内容,仅提供导航路径。
1、在当前知识库的任意文档编辑界面,将光标置于需插入链接的位置。
2、点击工具栏中的「链接」图标(或使用快捷键 Ctrl+K / Cmd+K)。
3、在弹出框中粘贴目标知识库的完整 URL(格式如:https://www.yuque.com/xxx/yyy),或手动输入知识库名称并从搜索建议中选择已公开/有访问权限的知识库。
4、点击确认后,该链接将以超文本形式呈现,支持鼠标悬停预览知识库封面与简介。
二、在文档中嵌入其他知识库的指定文档
此方式可在当前文档中直接显示另一知识库中某篇文档的实时内容快照(非 iframe 嵌入),且当源文档更新时,嵌入处会自动同步最新正文(不含评论、附件、历史版本等元信息)。
1、进入需嵌入文档的目标知识库,打开欲被引用的文档,复制其浏览器地址栏中的完整 URL。
2、返回当前编辑的文档,在光标位置输入斜杠“/”,随后输入“embed”触发嵌入命令菜单。
3、在下拉选项中选择「嵌入文档」,粘贴上一步复制的文档 URL。
4、确认后,系统将生成一个带缩略图与标题的嵌入卡片,卡片下方标注来源知识库名称及文档最后更新时间。
三、通过知识库分组实现逻辑关联
该方法不涉及技术性链接,而是利用语雀的“知识库分组”功能,在团队空间首页对多个知识库进行归类命名与视觉聚合,从而在组织层面体现业务或主题关联性,提升导航效率。
1、进入团队首页,滚动至「知识库分组」模块,点击右上角「+ 新建分组」。
2、输入分组名称(如“产品文档中心”“用户运营资料库”),保存后该分组即出现在首页左侧导航栏。
3、在任一知识库右侧操作区点击「⋯」按钮,选择「移动到分组」,从下拉列表中选取已创建的分组。
4、多个知识库移入同一分组后,用户点击该分组名称即可集中查看全部关联知识库,形成逻辑集群。
四、使用语雀 API 实现程序化知识库关联
适用于开发者或管理员需批量建立知识库间索引关系、构建跨库检索目录或同步元数据的场景。通过调用语雀开放平台的 RESTful 接口,可读取知识库列表、获取文档摘要、创建带自定义字段的关联索引页。
1、前往 https://www.yuque.com/yuque/openapi 申请个人或团队 Access Token,并确保权限包含“read_repo”与“write_doc”。
2、调用 GET /repos 接口获取目标知识库 ID(repo_id)列表。
3、使用 POST /docs 创建一篇新文档,其正文内容为 Markdown 格式的多知识库文档索引表,每行包含知识库名称、ID、关键文档链接及人工标注的关联类型(如“依赖”“参考”“衍生”)。
4、将该索引文档发布至统一的“关联中枢知识库”中,并设为团队成员默认可见。










