Freshly inserted macro sits on a placeholder for a long time before showing content

What you are seeing

You have just inserted a markdown macro, and it shows a placeholder for a long time before any content appears.


#Why it happens

The document exists but hasn't been indexed yet, so the macro checks again every 15 seconds, up to 10 times. That is about two and a half minutes.


#What to do

Wait a moment, then refresh the page. If the content never appears, open the macro's configuration and save the content again.


#Settings involved

Setting

Where

What it does

Global settings → Capabilities → Markdown

-

Hiding Markdown removes it from the Capable navigation bar and the byline menu across the whole site. It does not stop existing macros from rendering.

Global settings → Migration

-

Markdown is not excluded from migration, so its tab is included.

Markdown-specific settings

-

There is no settings page for Markdown on its own. Every switch above lives in the 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 appears in a scrolling box 1200 pixels high instead of inline on the page.

Very large documents

Starts at 500,000 characters

Very large documents are loaded in sections, and only the sections you can see are drawn.

Macro title and description length

50 characters each

The 'Markdown title' and 'Markdown description' fields in the macro configuration, and the title field in the from-scratch editor, all stop at 50 characters.



Found it? Good.