数据表
创建数据表
从命令面板新建表,或在文档里 `/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命名建议
- 表名用 复数 + 短 —
Projects、Contacts、Bugs,不是Project Tracker 2026 - 避免空格 — Agent 引用时
{{table:projects}}比{{table:project tracker}}干净得多 - 同义实体用同一张表 — Reading list 和 Bookmarks 合并比拆分有用
- 一个 vault 推荐不超过 30 张表 — 多了说明该归并或改用 select 字段了