# Confluence custom content types

Markdown documents are stored as two Confluence custom content types whose visible names differ per app: 'Capable Custom Content (Markdown)' / 'Capable Shared Storage (Markdown)' standalone, and '(Suite)' in the Suite. Both declare preventDuplicateTitle, indexing and unlicensedAccess.

---

## 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, kept in | Confluence editor → Markdown reference (Capable) / Markdown reference macro (Capable)                                                           |

---

## Settings that affect this

| **Setting**                              | **Where** | **What it does**                                                                                                                                                                                                               |
| ---------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 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   |

---

## 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 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.                                                              |

---

## Related

[Content indexing and CQL aliasesAnother connection.](https://help.gocapable.com/markdown/content-indexing-and-cql-aliases.html)

[Rovo agentAnother connection.](https://help.gocapable.com/markdown/rovo-agent.html)

[IntegrationsEvery connection.](https://help.gocapable.com/markdown/integrations.html)

---

_Better with company._