数据表

关联文档与数据表

用 `doc_link` 字段把表行链到文档;在文档里 backlinks 自动显示反向。

为什么需要把它们绑起来

Notion 用户最熟悉的一个痛点:项目有详细的文档(meeting notes、spec、retro),同时项目本身是表里的一行(状态、负责人、deadline)。两边各存一份,互相同步基本靠人工。

Kition 的解法是 doc_link 字段 — 它在表里指向 vault 里的某个 .md。链接是双向的:表行看得到文档,文档侧 backlinks 面板自动显示哪些表行指向它。

推荐模式:Projects 表 + Projects/ 文件夹

最干净的工作流:一张 Projects 表负责结构化字段(status / owner / due / score),一个 Projects/ 文件夹里每个项目一份 .md 负责非结构化讨论。表里加一个 doc_link 字段叫 notes,指向对应的文件。

在表里点 notes 单元格 → 跳进文档。在文档顶部 backlinks 自动出现:"This doc is linked from Projects → Launch v2"。删行不影响文档;删文档时 Kition 会问你要不要清空 link。

反向:在文档里嵌表

doc_link 是从表 → 文档。反过来从文档 → 表用 ![[Tables/...]] 嵌入语法。两边组合起来你就有了一个"以项目为中心"的工作台:项目文档顶部嵌任务表(过滤 = 该项目)、底部嵌相关 contacts。

# Launch v2

> Status: `[[Projects#Launch v2]]` (linked row)

## Tasks
![[Tables/Tasks?project=Launch v2]]

## Related people
![[Tables/Contacts?project=Launch v2&view=gallery]]

## Notes from kickoff
...

几个常见模式

  • CRMContacts 表 + People/<name>.md 写客户笔记;doc_link 跳转
  • Reading listReading 表存元数据(作者、tag、score)+ Reading/<title>.md 写读书笔记
  • Bug logBugs 表跟 repro 状态 + 每个 P0 bug 一份 Bugs/<id>.md 写排查日志
  • Research papersPapers 表记 BibTeX 元信息 + 文档写 takeaways;用 relation 把相关 paper 串起来
  • Hire pipelineCandidates 表跟阶段 + Candidates/<name>.md 存简历 + 面试 notes

同步与清理

  • 改文档文件名 — doc_link 自动跟随(vault 内的文件系统事件被监听)
  • 把文档移到别的文件夹 — 链接保持
  • 删文档 — Kition 弹确认:"这会留下 3 个 broken link,是否清空?"
  • broken link 可在 Settings → Diagnostics → "Find broken doc_links" 一次性扫描修复
  • 团队 vault 下,链接同步靠 vault 协议;冲突时保留最新写入者

相关文档

下载 Kition

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