Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

5.4 KB
Raw Blame
---
title: "Documents"
icon: "file"
description: "Markdown-native, fast, collaborative, and @linked 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](/product/drive)) and enriched with tags.

Watch a 1:15 walkthrough of Macro Docs.

<video src="https://macro.com/video/tutorials/docs.mp4" poster="https://macro.com/video/tutorials/docs-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />

Macro 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](/product/drive).

<video src="/videos/Macro-Markdown-Demo.mp4" controls />

Collaboration in Macro 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 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 (<kbd>cmd</kbd>\+<kbd>b</kbd>), italic (<kbd>cmd</kbd>\+<kbd>i</kbd>), underline (<kbd>cmd</kbd>\+<kbd>u</kbd>), strikethrough (<kbd>shift</kbd>\+<kbd>cmd</kbd>\+<kbd>x</kbd>), highlight (<kbd>shift</kbd>\+<kbd>cmd</kbd>\+<kbd>h</kbd>), inline code (<kbd>cmd</kbd>\+<kbd>e</kbd>), plus superscript and subscript.

Markdown autoformatting works as you type (`#`/`##`/`###`, `-`, `1.`, `[]`, `>`, `---`, and backticks), `:shortcode:` emoji are supported, blocks can be dragged to reorder, <kbd>tab</kbd>/<kbd>shift</kbd>\+<kbd>tab</kbd> indent and outdent, and find & replace (<kbd>cmd</kbd>\+<kbd>f</kbd>) 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](/product/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](/product/search#filtering-by-tags) by tag to slice your workspace the way you would in a Notion database. See [Properties](/concepts/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 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.