Documents

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 to provide a Notion-like database experience with filters. Unlike Notion, Macro does not currently permit nesting of documents-within-documents-within-documents; all documents are stored somewhere, whether that be at the root-level (un-filtered) 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 docs shared with you, go to “Files”.

To create a new markdown document use shortcut c + d

You’ll notice collaboration in Macro docs is really 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 Macro 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 Macro.

​

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. The slash menu (/, or the command menu) inserts any of these: Normal text, Heading 1/2/3, Blockquote, Code block, Bullet/Numbered/Checklist, Task (an inline task with mentions), Image, Video, Link, Equation (/latex or /math), Table (5×3), and Divider. @mentions render in the body as collapsible inline pills. Typing ; opens the snippets menu to insert reusable content.

​

Comments & history

Comments are inline and thread-based, anchored to a text selection. You can reply, resolve and unresolve, draft, and edit or delete your own. Full version history is available via time-travel: browse historical states grouped by user and time, and fork a document at any past version into a new doc.

​

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, toggle an optional YAML front-matter display, 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 Macro 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 Macro message auto-updates its permissions so recipients can open it. Copy a link with shift+cmd+c, or export a document to markdown text.