# Share a Markdown doc with an AI agent in one link

Source: https://www.gryz.ai/docs/guides/use-cases/share-markdown-with-ai-agents/
Updated: 2026-11-18

## Before you start [#before-you-start]

* **Nothing, for a quick share.** Quick Publish works without an account.
* **A free Gryz account,** if the doc should be private or your agent should write back to it.

## Why this matters [#why-this-matters]

Pasting a long spec into every chat is slow, and each tool ends up with its own copy. A link is one copy that every agent and person reads. With a Gryz account, change it once, and the next agent that opens the link sees the change. A link published without an account can't be changed.

## Share it in one link [#share-it-in-one-link]

1. Open [Quick Publish](/publish/).
2. Paste or upload your Markdown. HTML and SVG work too, up to 25 KB without an account.
3. Check the preview, tick the terms box, then select **Publish**. The link is copied to your clipboard, and there's also a **Copy** button.
4. Paste it into your agent's chat, for example: "Read this spec and list the open questions," followed by the link.

Without an account, the link is public and expires after 24 hours. Anyone with it can read it, so don't publish anything private this way.

## Give the agent the exact Markdown [#give-the-agent-the-exact-markdown]

A Gryz link like `/d/<slug>/` shows the doc as a web page. Most agents can read that. For the exact text you wrote, open the document's menu and choose **View raw**. That opens `/raw/<slug>/`, which returns the plain Markdown with no page around it.

* The raw link follows the same rules as the doc. A private doc stays private, and an expired link stops working.
* HTML comes back as plain text too, so an agent reads the markup, never a running page.

## When the agent should keep it private or write back [#when-the-agent-should-keep-it-private-or-write-back]

A public link is one-way: the agent reads it, and that's it. Connect your agent to Gryz instead when:

* **The doc is private.** A free account keeps 3 private docs, and your connected agents can read them. No public link needed.
* **The agent should write back.** It can publish a doc with `publish_document`, read just one section with `get_document`, and change one section with `edit_document`.
* **Several agents share it.** ChatGPT, Claude, Cursor and Codex all read the same doc from the same account.

Set it up in [MCP setup](/docs/mcp/setup/), then ask: "Save this spec to Gryz as a private doc."

## Copy-paste prompt [#copy-paste-prompt]

```text
Save the Markdown below to Gryz as a private document called "Launch spec", then send me the link. Also remember: when I ask about the launch, read this document first.
```

## How long links last [#how-long-links-last]

| Plan         | Public links   | Private docs |
| ------------ | -------------- | ------------ |
| No account   | 24 hours       | None         |
| Free account | Up to 72 hours | 3            |
| Pro          | Up to 30 days  | 50           |
| Pro Plus     | Permanent      | Unlimited    |

See [pricing](/pricing/) for the rest.

## Next steps [#next-steps]

* [Keep living docs current with your agent](/docs/guides/use-cases/keep-living-docs-current-with-your-agent/)
* [How to share context between ChatGPT and Claude](/gryzle/share-context-between-chatgpt-and-claude/)
