Writing Documents

Documents in Saltare are markdown-powered collaborative files where humans and AI agents work side-by-side. They support version history, discussion threads, wiki-style linking, and agent-powered content creation.

Creating Documents

From the Sidebar

1. Navigate to a document group in the sidebar
2. Click New Document
3. Enter a title and start writing

From Chat

Ask an agent to create a document:

@Assistant create a document titled "API Integration Guide" 
with sections for authentication, endpoints, and error handling

The agent will create the document, write the initial content, and share a link in the thread.

The Editor

The document editor uses Markdown — a simple formatting syntax that lets you write structured content without a complex toolbar.

Basic Formatting

• **bold** for bold text
• *italic* for italic text
• ~~strikethrough~~ for strikethrough
• `code` for inline code

Structure

• # Heading 1 through ###### Heading 6 for headings
• - or * for bullet lists
• 1. for numbered lists
• > for blockquotes
• --- for horizontal rules

Code Blocks

Wrap code in triple backticks for syntax-highlighted code blocks:

```python
def hello():
    print("Hello, world!")
```

Tables

Use pipes and dashes for tables:

| Column 1 | Column 2 |
|----------|----------|
| Data     | Data     |

Live Preview

Toggle between edit and preview modes to see your rendered markdown in real-time. The preview matches exactly what other users will see.

Wiki-Style Linking

Link between documents using double-bracket syntax:

See [[Project Overview]] for background context.

Saltare automatically resolves the document by title and creates a clickable link. This also creates a backlink — the linked document knows which other documents reference it.

Version History

Every save creates a version snapshot. You can:

• View the full history of changes
• Compare versions to see what changed
• Restore any previous version with one click

Version history is automatic — no manual saving required.

Document Groups

Documents are organized into groups, similar to task groups:

• Each group has a name and appears in the sidebar
• Groups have auto-created discussion channels
• Documents can optionally belong to a group
• Groups support archiving

Collaboration

Discussion Threads

Every document has an auto-created discussion channel. Use it to:
- Discuss changes with your team
- Ask agents to review or update content
- Leave feedback without modifying the document itself

Collaborator Tracking

Saltare tracks who has edited each document, so you always know who contributed.

Agent Co-Authoring

AI agents can create, read, update, and search documents. Common workflows:

Agent-Written Research

@Researcher analyze our top 5 competitors and write a 
comparison document with pricing, features, and market position

Agent Editing

@Writer review the "Q2 Report" document and improve 
the executive summary section. Make it more concise.

Agent Document Search

@Assistant find all documents that mention "API migration" 
and summarize the key decisions

Publishing

Documents can be published to make them more prominently visible within the workspace. Published documents signal that the content is finalized and ready for reference.

Tips

• Start with structure — Write headings first, then fill in content. This makes it easy for agents to update specific sections.
• Use wiki-links — Connect related documents to build a knowledge base that's easy to navigate.
• Leverage agents for first drafts — Let an agent write the initial structure, then refine it yourself.
• Keep discussions in the thread — Use the document's discussion channel for feedback rather than editing comments directly into the body.