Skip to Content
MosaicMosaicDocs

Documents

Markdown-native, fast, collaborative, and @linked documents.

Starter documentation. Features and account details may differ from this deployment.

Documents are markdown-native text files that are tied to the rest of your workspace with @mentions. They can be organized in folders like a traditional file system (see Folders) and enriched with tags.

Mosaic does not permit nesting of documents-within-documents-within-documents; all documents are stored somewhere, whether that be at the root-level or in a folder. The primary way of sharing documents is by hitting Share or @linking them in a message. To see your documents and files shared with you, go to Drive.

Collaboration in Mosaic docs is extremely fast. Edits from your teammates seem to appear almost instantly as if working locally on the same machine. Edits even to the same line resolve and do not thrash. This is all because Mosaic uses CRDTs + durable objects to ensure that multiple teammates can type in the same doc, task, or message simultaneously and so users can keep working with no network connection.

You can @mention documents in your channels, link to them in your tasks, or ask an agent questions about a contract someone emailed you. Documents are always fully searchable inside Mosaic.

Editing & formatting

The editor supports the full set of block nodes: paragraphs, Heading 1/2/3, bullet/numbered/checklist lists (with interactive checkboxes), blockquotes, code blocks (Prism syntax highlighting across 15+ languages), tables, dividers, images, videos, and links, plus inline and block math rendered with KaTeX. Inline formatting follows the usual shortcuts: bold (cmd+b), italic (cmd+i), underline (cmd+u), strikethrough (shift+cmd+x), highlight (shift+cmd+h), inline code (cmd+e), plus superscript and subscript.

Markdown autoformatting works as you type (#/##/###, -, 1., [], >, ---, and backticks), :shortcode: emoji are supported, blocks can be dragged to reorder, tab/shift+tab indent and outdent, and find & replace (cmd+f) supports regex and replace-one/replace-all. Type / or open the command menu to insert a block. @mentions render in the body as collapsible inline pills. Typing ; opens the snippets menu to insert reusable content.

Outline

Longer documents show an outline on the left edge: a column of dashes, one per heading, that tracks your place as you scroll, with the dash for the section you're reading highlighted. Hover the outline to expand the full list of headings, and click any heading to jump straight to it. The outline appears once a document has at least three headings and the window is wide enough to fit it, and stays out of the way on mobile and while browsing version history.

Tags

Type # in a document — in the title or the body — to open the tag menu. Pick an existing tag or create a new one, choosing its color and whether it's a personal tag or one shared with your team. Tags render inline as colored pills; click one to see everything else carrying it. Tagging turns a set of documents into a lightweight database: filter your files and search by tag to slice your workspace the way you would in a Notion database. See Properties for how tags fit into the wider property system.

Comments

Comments are inline and thread-based, anchored to a text selection. You can reply, resolve and unresolve, draft, and edit or delete your own. @mention someone in a comment and they receive a notification.

Version history

Version history is every earlier state of a document, grouped by who edited it and when. Open the … menu on the document title and choose History. Pick a session, or move along the timeline, to preview that version. Current version returns to the live document. Fork copies the version you are viewing into a new document.

Notifications

@mentioning a person in a document's body does not notify them. For a person to receive notifications from a document, it must first be shared with them. On the other hand, if you @mention someone in a comment, they will be notified.

Properties

On the right-hand side of your document (or inside the Info panel, depending on your split size) you can see document details (owner, folder, created and updated) as well as properties. Properties let you assign the document, link it to a task, set urgency, and more. You can pin properties so their values render as pills under the title, and see a live word and character count.

Sharing & export

Documents use the standard access levels: owner, editor, commenter, and viewer. You can share documents with people outside Mosaic by using their email address, or by giving them a URL link if the Public Link has been enabled in the Share menu. Users who aren't signed in see a document preview without having to log in or create an account. Sharing a doc through a Mosaic message auto-updates its permissions so recipients can open it.

On this page