guide/notes
Notes and links
Data rarely comes without remarks: "this refund is still pending", "these emails were never validated", "Q1 numbers are preliminary". Text Tables lets you pin them to exactly what they're about — without touching the data.
note
txtab
# note key=1042 col=amount author=alex@example.com text="Refund pending, see ticket 1234"
# note col=email text="Addresses imported from the old CRM were never validated"
# note key=1042 text="Test order, exclude from the report"
# note text="Numbers are preliminary until the audit closes"| You give | The note is about |
|---|---|
a row (key= or row=) and col= |
one cell |
col= only |
a column |
| a row only | a row |
| nothing, in a table block | the table |
| nothing, in the file block | the whole file |
key= finds the row by its id (the column with role=id), so the note stays on the right row after sorting or filtering — even by tools that know nothing about Text Tables. row= counts rows from zero and only works while the order doesn't change. Prefer key=.
Notes are flat: no threads, no replies, no "resolved". They're for the handful of remarks a person actually leaves — a per-row status belongs in a column.
link= on a column
txtab
# column name=order_id type=long role=id link="https://crm.example.com/orders/{$}"
# column name=customer type=string link="https://crm.example.com/c/{customer_id}"
# column name=homepage type=string link="{$}"Every value becomes a link. {$} is the cell's own value, {name} another column's value in the same row. The cell still shows its value; the link only says where it points.
link on one cell
txtab
# link key=1003 col=invoice href="https://billing.example.com/inv/A-77"For the one-off link that doesn't follow the column's pattern.
Safety
Links from someone else's file are untrusted. Tools never open them on their own, and only http, https and mailto links are shown as links — after the template is filled in, so a value like javascript:… can't sneak through link="{$}".
Reviewing data you can't change
Notes and links work in a .txtab that describes an external CSV with reference=. That's the cleanest way to review a file you aren't allowed to edit: the CSV stays untouched, the remarks travel next to it.