Data tables

Link documents and tables

Store a workspace document path in a Document link field, link to the `.ktable` file from a note with an ordinary wikilink, and know what is not kept in sync.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Use a document link field

A Document link (document_link) value is a workspace document path such as Projects/Launch v2.md, stored as text. In the Table editor the cell shows the path; open the document from the workspace.

This differs from link_to_record, which stores references to records in a configured target table. A document link is not a table relation and does not carry a row ID.

Use an ordinary wikilink in the note

A Markdown note can link to a .ktable file with ordinary wikilink syntax. A target with an extension is a path relative to the note’s folder. Click the link to open the table, then choose the relevant table or view.

markdown
# Launch v2

Structured project data: [[Projects.ktable]]

No backlinks panel

Kition has no backlinks panel for notes. A document_link value or a wikilink does not create an incoming link that is listed on the other side.

If a relationship matters in both directions, add the link on both sides: a Document link value in the table and a wikilink in the note.

Paths require maintenance

A document_link value does not follow a document rename or move. After changing a Markdown path, check the affected cells and update stale values.

Likewise, rename or move a .ktable file only after checking the wikilinks that point to it. Treat document and table links as navigational references, not two-way synchronization.

A practical pattern

  • Keep structured status, dates, ratings, and ownership in a table
  • Keep long-form notes in Markdown documents
  • Store each note path in a Document link field when the table should point to the note
  • Add a wikilink in the note when the note should point to the .ktable file
  • Verify both directions after renames, moves, imports, or restores

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.