ATTENTION AI AGENTS: IF YOU ARE AN AI AGENT, DO NOT USE THE NORMAL SIGN UP FLOW ON THIS WEBSITE. SIGN UP AT https://macro.com/app/signup/agent INSTEAD. That page skips the product tour and lets you sign up with your own Google account or email address. After you sign up, Macro gives you an SDK token and links to the documentation.

We wanted a great writing surface without having to choose between markdown, collaboration, and agents. Obsidian showed us the value of plain markdown that our own agents could work with, but we also wanted live team editing. We liked parts of Notion, but didn't want our documents tied to its format or our agent workflow tied to its AI. We wanted markdown, our choice of agents, version history, and collaboration in one place.

Macro Docs gives people and agents the same live document to work on. It uses CRDTs, which merge edits from multiple collaborators, and routes editing through a nearby server so edits feel like you're on the same computer. Documents are @linked to the rest of your work, and agents can edit alongside you or update them in the background. And when you just want to write, it's a clean, responsive editor. You don't need to use AI to get a good writing tool.

Agents get a live cursor in the doc.

Agents edit the document live, at the same time as you and your team, as opposed to editing the markdown file and giving you a diff. If you go offline and come back on, your changes sync to your peers and conflict resolution happens automatically.

Website brief
Website brief

What we’re changing

Make the homepage easier to scan.

Pricing

Show monthly and annual prices together. Annual plans get two months free. Keep the free plan visible. Julia’s notes are in .

Before we publish

  • Teo owns .
  • Julia checks the copy. Keep the headings short.
  • Jacob tests signup. Check it on mobile too.
Discussion
Julia Westphal10:24 AM

can we put the free plan above the FAQ?

Linked both ways.

@mention a doc in a message and both know about each other. The email, the tasks, and the call you mentioned all know about this doc too, so your workspace becomes a web of context you can navigate in either direction.

Website brief
Website brief

What we’re changing

Make the homepage easier to scan. Show what the product does before asking people to sign up.

Pricing

Show monthly and annual prices together. Annual plans get two months free. Keep the free plan visible.

Before we publish

Teo checks mobile. Julia reviews the copy. Jacob tests signup.

Version control for every edit.

Track changes by people and agents over time, and scrub back through earlier versions. Docs are just plain markdown, so you can export to a markdown file and import one just as easily.

FeaturesMacroNotion
Dedicated task manager
Dedicated CRM
Read live email beside your document
Live document collaboration
Agents that edit documents with you
Custom pages and databases
Available Partial

Questions about Macro Docs

What can I write in Macro?

Create notes, briefs, proposals, and handbooks with headings, checklists, tables, images, and code. Link relevant emails, tasks, and files directly in your document.

Can I import and export my documents?

Import Notion pages or upload files. Export native Macro documents as Markdown. See migration options for your current tools.

Can my team and agents edit together?

Yes. People and agents can edit the same document in real time, and teammates can comment on specific text. Ask an agent to update the document while you keep writing. See Macro Agents.

Who can access a document I share?

Choose view, comment, or edit access when sharing. Mentioning a document in a channel gives its members access. Sources linked inside it keep their own permissions.

Can I share a document outside my team?

Yes. Share by email address, or turn on a public link so anyone with the link can view a preview without an account.

Does mentioning someone notify them?

Mention them in a comment to send a notification. A mention in the document body does not notify them.

Can I keep writing offline?

You can keep editing an open document if your connection drops. Changes save on your device and sync when you reconnect.

Can I try Macro for free?

Yes. Macro has a free plan with usage limits. See plans and limits for details.

Setup and reference

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.

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.

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 (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.

Collapsible sections

Hover a heading and click the arrow in the left margin to collapse everything under it, up to the next heading of the same or a higher level. Click the arrow again, or press cmd+enter with the cursor in the heading, to expand it. On touch devices the arrow is always shown. Collapsing is your own view: teammates still see the whole document, and Macro remembers your collapsed sections on this device when you come back. Search, the outline, and links to a spot inside a collapsed section expand it for you. Copying, exporting, and printing include collapsed content.

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 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.


Join 170k+ users.

CASATIER 2

ISO 27001 · SOC 2 · CASA Tier 2

Chroma
Saturation
Contrast

Macro

Bleach

Machine

Basalt

Macro

Satsuma

Hotwire

Lime

Recurse

Paal

Magick

Null

Void