Confluence custom content types
Markdown documents are stored as two kinds of Confluence content. Their names depend on the app. The standalone app uses 'Capable Custom Content (Markdown)' and 'Capable Shared Storage (Markdown)', and the Suite adds '(Suite)' to each.
In both, two items can't share a title, the content is indexed for search, and unlicensed users can still access it.
#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 |
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 | Confluence editor → Markdown reference (Capable) / Markdown reference macro (Capable) |
#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. |
Space settings → Space Capability Settings | - | 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. |
Global settings → Permissions | - | Controls who can edit the Global library, and so who can create Global markdown templates. The setting is shared with diagrams, images, calendar and search. |
#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. |
URL fetch size limit | 2.5 MB | A document fetched from a URL that is larger than 2.5 MB is rejected (error 413), and so is an unsupported content type (error 415). Capable also upgrades http links to https, refuses anything that isn't http or https, and blocks IP addresses used as URLs. |
New template appearing in the list | Up to several seconds | After you create a template, Capable waits for Confluence to list it, so it can take a few seconds to show up. |
#Related
Better with company.
