# Content indexing and CQL aliases

A markdown content indexing records referenced template ids under markdown.refs in the capable\_refs content property, exposed to CQL as <APP\_HASH>\_capable\_refs\_markdown\_refs. Writes are re-indexed by created/updated custom-content triggers filtered to Capable content whose title starts with 'markdown', plus an explicit index call the macro makes right after saving. Those product triggers are filtered on appIsLicensed: true.

---

## 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                                                      |
| Save a document to the shared library     | Capable Markdown page → Templates → Space templates or Global templates → Create                                                                |

---

## 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.                          |
| 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 |
| Global settings → Indexing               | \-        | Runs on-demand backfill of the capable\_refs content property that the byline count, the 'Used on Pages' panel and the markdown-ref CQL aliases all depend on.                                                               |

---

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

---

## Related

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

[MCP surfaceAnother connection.](https://help.gocapable.com/markdown/mcp-surface.html)

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

---

_Better with company._