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
How it actually behaves.
