Confluence custom content types

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

Import a markdown file from your computer

Configure Markdown → Markdown from scratch → 'Upload file', or drop the file on the editor

Reuse one markdown document across many pages, kept in

Confluence editor → Markdown reference (Capable) / Markdown reference macro (Capable)

Global settings → Capabilities → Markdow

-

Hiding Markdown removes it from the Capable nav bar and the content byline menu across the site (app property capable-global-hidden-capabilities). It does NOT stop existing macros from rendering.

Space settings → Space Capability Settin

-

Auto shows the byline entry only when the page already carries markdown; Always pins it in every page's byline in that space; Never hides it there. Stored on the space property <APP_HASH>_capable under capabilities.alway

Global settings → Permissions

-

Controls edit access to the GLOBAL asset store. Which is what governs who may create Global markdown templates. It is shared with diagrams, images, calendar and search because they all use one Confluence custom content t

Large-document scroll mode

500,000 characters

Past this the document macro shows '⚠️ Large content detected. Rendering in scrollable mode.' and renders inside a fixed 1200px-high scroll box instead of inline.

URL fetch size limit

2.5 MB

A URL-sourced document larger than 2.5 MB is rejected with 413; a disallowed content type is rejected with 415. The proxy also upgrades http to https, refuses non-http(s) schemes, and blocks IP litera

New-template catalogue polling

8 attempts, backoff up to 8 seconds each

After creating a template the app polls for the Confluence-side listing to include it, so a new template can take several seconds to appear.