# Sharing a document

'Copy URL' produces a deep link to the view page. 'Copy as macro' produces the reference URL .../assets/markdown/templates/<id>, which pastes into a page and auto-converts into the reference macro. Reference URLs are offered only for custom-content-backed documents. Never for bundled examples, URL-sourced or attachment-sourced markdown.

---

## Where you do it

| **Task**                                   | **Where**                                                                                                                                       |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Add a markdown document to a page          | Confluence editor → /Markdown (Capable) \[Suite\] or /Markdown macro (Capable) \[standalone\], or the Markdown byline entry on a published page |
| Write or edit the document body            | The macro's Configure action, the maximize button on the rendered macro, or Edit on the library page                                            |
| Upload or paste an image into the document | Editor toolbar → + → Image 'From upload', paste from the clipboard, or drop the file on the editor                                              |

---

## Worth knowing

* The document macro's Title is not written by the released config UI: it is saved onto the stored document, and the header shows that document's title.
* The macro reads the raw config and the form defaults set an empty array.
* URL-sourced documents show nothing to logged-out readers; attachment- and page-stored documents render for them.
* Documents over 500,000 characters render inside a fixed-height scroller with a visible warning banner.
* The duplicate-title check only inspects documents directly under the space's Capable storage, and if the check itself fails the save proceeds anyway.
* A macro whose stored document belongs to a different page refuses to save. This is what a copied page hits before reconciliation.

---

## Limits that apply here

* Large-document scroll mode
* MCP / Rovo document size cap

---

## Related

[Three-mode markdown editorAnother part of how this works.](https://help.gocapable.com/markdown/three-mode-markdown-editor.html)

[Insert (+) menuAnother part of how this works.](https://help.gocapable.com/markdown/insert-menu.html)

[How it worksThe rest.](https://help.gocapable.com/markdown/how-it-works.html)

---

_How it actually behaves._