Writing and editing documents

Opening a document in Tatara is the same thing as editing it. There is no separate read mode and no Edit or Done button. You click into the text and type, and Tatara saves what you change.

​

The title

The title sits at the top of the reading column as a plain text input. An empty title shows Untitled as placeholder text. As you type, the breadcrumb above the document updates to match. A title cannot contain /, #, |, [, ], or a line break. If you use one, the save is rejected and you see:

Title may not contain any of / # | [ ] or line breaks.

The title also determines the document’s address. Renaming a document moves it to a new URL and rewrites links to it from other documents in the same operation. See Folders and organization.

​

The body

The body is a rich text editor that stores markdown. An empty document shows Start writing…. You can write paragraphs, headings at three levels, ordered and unordered lists, quotes, and inline emphasis. The editor is deliberately small. It has:

• No code block support.
• No toolbar.
• No slash menu.
• No way to switch to a raw markdown view.
• No table or image insertion.

If a document already carries YAML frontmatter at the top of its body (from an agent write, for example), that block is preserved exactly as written on every save. It is never parsed into the editor and never shown to you.

​

Autosave

There is no save button. Roughly half a second after you stop typing, your changes are written. Navigating away flushes anything still pending, so you do not lose a keystroke by clicking to another document. The current state is shown in the topbar:

​

Document width

The topbar has a three-way width control labelled Document width, with options Prose, Wide, and Full. Click an option, or use the arrow keys to move between them once one is focused.

​

The properties rail

The rail on the right holds everything about the document that is not its title or body. Toggle it with ⌘I (Ctrl+I on Windows) or the topbar button, which reads Collapse properties (⌘I) when the rail is open and Show properties (⌘I) when it is not. Your choice persists.

​

Owner, type, and description

Owner is a dropdown. It shows the person’s name or email, or Unassigned when nobody is set, and Unassigned is always available as an option. Type is a free text field for what kind of document this is, with signal, brand, … as placeholder text. Description is a free text field for one sentence on what the document is. Both commit when you press Enter or click away, and revert if you press Escape. Clearing a field to empty removes the value.

​

Tags

Tags are chips with a remove button each, plus an Add tag input. Press Enter or click away to add. Adding a tag that is already there does nothing. The input accepts anything you type. There is no picker, no autocomplete, and no check against your tag registry.

​

Links and linked mentions

Links lists the documents this one points at. Linked mentions lists the documents that point back at it. Both are read-only; click a row to open that document. Links to documents that do not exist yet appear dimmed and are not clickable, and they resolve on their own once a matching document is created. The whole card disappears when a document has neither outbound links nor mentions.

​

Custom and timestamps

Custom lists any additional properties stored on the document beyond the standard ones, sorted alphabetically. These are read-only in the web app: an agent can write them, you cannot edit them here. Created and Updated sit at the bottom of the rail as relative times. Both are read-only.