Docs, versions, and links
Docs are where the prose lives. This guide covers working with them from the human side.
Editing
Section titled “Editing”The editor is a block editor: headings, lists, tables, code, diagrams, drag-to-reorder. It’s collaborative under the hood (you and an agent can touch the same doc simultaneously without stepping on each other), and offline edits sync when you’re back.
Click New doc without typing a name and Worktable names it untitled (or untitled-2, and so on) — the sidebar label switches to the doc’s first heading as soon as it has one. Drag docs and folders in the sidebar to set your own order; it’s saved and syncs to your other clients.
Markdown in, markdown out
Section titled “Markdown in, markdown out”Agents write docs as markdown; simple docs are stored as .md files you can open anywhere. Rich content is stored as structured JSON, and agents can still read it as markdown. Nobody has to care which format a doc is in. Doc paths are slugs derived from titles (research/competitive-analysis), so filenames stay clean no matter who writes.
Need a doc’s content somewhere else? “Copy as Markdown” — in the doc header, or the sidebar’s right-click menu — copies it as clean markdown, converting from rich text if that’s how it’s stored. The doc header’s download menu also has “Download Markdown” (saves a .md file) and “Print / Save as PDF” (opens your browser’s print dialog with a clean, chrome-free layout); “Download” is available in the sidebar’s right-click menu too.
Version history
Section titled “Version history”Every doc keeps history, kept forever by default. Open it from the doc menu to read old versions, mark a checkpoint before risky work, or restore. This is what makes “let the agent rewrite it” a safe instruction because a bad rewrite is one restore away. If a workspace is growing large, trim retention to a time window or a per-doc count in Settings → History; tightening it deletes older versions immediately, so Worktable confirms before applying.
HTML docs keep their own history and checkpoints. Restoring an older version changes the HTML doc itself but does not roll back its saved interface state.
Links and the graph
Section titled “Links and the graph”Link docs by path [Title](/other-doc) and Worktable tracks the graph: backlinks show up on Space Home, and automatic lint flags broken links and orphaned docs as annotations that resolve themselves once fixed. Links behave like regular web links, so you can open one in a new tab or copy its address. Ask your agents to link related docs; the graph is how a space stays navigable at fifty docs.
Renaming a doc or moving a folder doesn’t break the links that point at the old path: existing links and bookmarks keep resolving to the doc’s new location.
Diagrams
Section titled “Diagrams”Worktable checks Mermaid diagrams in docs before saving them. When an agent builds a diagram inside an HTML doc, it checks that diagram before embedding it.