Macro migrators
Macro migrators are run from the Migration settings tab.
#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 maximise button on the rendered macro, or Edit on the library page |
Show a border and a title on the macro | Configure Markdown → 'Show border' checkbox and the 'Markdown title' field |
#Settings that affect this
Setting | Where | What it does |
|---|---|---|
Global settings → Capabilities → Markdown | - | Hiding Markdown removes it from the Capable navigation bar and the content byline menu across the whole site. It does not stop existing macros from rendering. |
Global settings → Migration | - | Markdown isn't on the tab's exclusion list, so the Migration tab is available. |
Markdown settings tab | - | There isn't one. Markdown adds a byline entry, query actions, an asset browser, a Search panel, a content renderer, migrators and two macros. Every switch above lives in shared Capable settings. |
#Limits that apply here
Limit | Value | What happens |
|---|---|---|
Large-document scroll mode | 500,000 characters | Past this, the document macro shows "Large content detected. Rendering in scrollable mode." and displays the document in a fixed-height scroll box instead of inline. |
Very large documents | Above 500,000 characters | The document loads in sections, and only the sections you can see are rendered. |
Macro title and description length | 50 characters each | The 'Markdown title' and 'Markdown description' fields in the macro's settings, and the title field in the from-scratch editor, stop at 50 characters. |
#Worth knowing
The macro's Configure screen doesn't set the document title. The title is saved with the stored document, and the macro header shows that document's title.
A macro whose stored document belongs to a different page can't be saved. A copied page hits this until it has been reconciled.
'Used on Pages' and the byline count both rely on indexed data. 'Used on Pages' counts only reference-macro usage, so a plain document macro doesn't add to it.
Logged-out readers never see the byline, whatever access the macros allow anonymous users.
#Related
Better with company.
