数据表

创建数据表

从命令面板新建表,或在文档里 `/table` 触发。

三种创建方式

Kition 的表是一等公民 — 它不是文档里的一个块,而是独立的实体,跟 .md 文件平起平坐。三种入口对应三种心智:从功能找、从写作流找、从目录找。

  • 命令面板Cmd+K → "New table" — 适合从零开始
  • 文档内 /table — 在写作时顺手插入一张迷你表,绑定到当前段落
  • 右键 Vault 树 → "New table here" — 把表放到指定文件夹下

初始化向导

创建新表会弹出一个轻量向导:给表起名、选一个起始模板(Blank、Task tracker、CRM、Reading list、Bug log),然后立刻进入编辑状态。模板只是预填了字段 — 之后随时改字段、删字段。

Kition 不强制 schema first — 你可以先随便添几列文本,等数据累计起来再改类型。改类型时旧值会被尝试 cast,cast 失败的值会保留为字符串并标记 warning。

存放位置与文件格式

每张表都是 <vault>/Tables/<name>.kitable 这样一个独立文件。.kitable 既包含行数据,也包含视图、过滤、排序、分组等元数据 — 一张表,一个文件,可以单独拷走、备份、分享。

想看原始数据?任何时候都可以 kition table export <name> --format json--format csv 一键导出,无需打开 app。

# Inspect a vault from the command line
kition --vault . table list

projects       42 rows   updated 2026-06-04
reading       128 rows   updated 2026-06-06
bug_log        17 rows   updated 2026-06-07

# Export one table as JSON for scripting
kition --vault . table export projects --format json > projects.json

命名建议

  • 表名用 复数 + 短ProjectsContactsBugs,不是 Project Tracker 2026
  • 避免空格 — Agent 引用时 {{table:projects}}{{table:project tracker}} 干净得多
  • 同义实体用同一张表 — Reading list 和 Bookmarks 合并比拆分有用
  • 一个 vault 推荐不超过 30 张表 — 多了说明该归并或改用 select 字段了

相关文档

下载 Kition

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