文档编辑器

在文档里嵌入数据表

`![[Tables/projects]]` 把整张表或一个视图嵌入文档。

为什么要嵌入

文档擅长讲故事,数据表擅长跟踪状态。两者各有所长 — 但用户经常想在一份周报里既写「这周的总结」又附上「具体的任务清单」。

嵌入语法把表的当前快照实时渲染进文档:写的时候你看到的就是阅读时看到的,数据永远是最新的,不用复制粘贴。

语法

![[Tables/projects]]                  # 整张表 / whole table
![[Tables/projects#active]]           # 一个视图 / a single view
![[Tables/projects?status=todo]]      # 过滤 / filtered inline
![[Tables/projects?limit=5&sort=-updated]]   # 排序 + 限制 / sort + limit
![[Tables/projects.row:a7f2]]         # 单行 / a single row

内联查询参数

  • ?status=todo — 单字段过滤
  • ?status=todo,doing — 多值(OR)
  • ?priority>=2 — 比较运算(>, >=, <, <=, !=)
  • ?sort=-updated — 排序(- 表示倒序)
  • ?limit=10 — 限制条数
  • ?fields=name,status,owner — 只显示指定列

实际场景

周报里嵌入「本周完成的任务」视图 — 自动保持最新,不用手动复制。

在 RFC 文档底部嵌入「相关 ADR 表的过滤视图」,决策上下文一目了然。

在每日笔记顶部嵌入「今天到期的任务」,打开就是 todo list。

## 本周完成

![[Tables/tasks?status=done&updated>=-7d&fields=name,owner,closed_at]]

## 进行中

![[Tables/tasks?status=doing&owner=me&sort=-priority]]

编辑权限

  • 默认嵌入是只读的 — 防止误改
  • 在嵌入块上方按 Cmd/Ctrl + E 切换可编辑(行内改字段、勾 checkbox)
  • 改动会直接写回源表 — 嵌入只是个视图,不是副本
  • 删除文档不会影响表数据;删除表才会让嵌入失效

相关文档

下载 Kition

本地优先的 AI 工作空间。Markdown 文档、结构化数据表、AI Agent,全部跑在你自己的电脑上。