# Markdown library page

A 'Capable Markdown' global page and space page with the catalogue at /conf/page/markdown and create / edit / view routes beneath it. Page title 'Markdown', subtitle 'Embed, share, and edit markdown content'. The edit view shows an Edit pane beside a Preview pane with Show Code / Hide Code and an 'Open documentation' link to GitHub's markdown syntax guide. Catalogue view modes: Grid, List, Table (carried in the ?view search param).

---

## Where you do it

![The Capable Markdown catalogue in a dialog headed Markdown, with a left nav listing Getting started, Markdown on pages with My markdown and All markdown, Templates and Examples, and a table of documen](https://help.gocapable.com/images/904be536-a60a-4c42-b1bd-38ba5181eca5.webp)

Opened at All markdown, the catalogue lists every document held on a page along with the page it sits on.

| **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 |
| Write or edit the document body        | The macro's Configure action, the maximize button on the rendered macro, or Edit on the library page                                            |
| Show a border and a title on the macro | Configure Markdown → 'Show border' checkbox and the 'Markdown title' field                                                                      |

---

## 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 → Features → AI integrat | \-        | 'Allow AI-powered features across Capable. Turn off to disable AI for all users.' Turning it off removes the Studio (Generate markdown with AI) section from the markdown catalogue. Studio additionally requires the app's    |

---

## Worth knowing

* Exactly two Confluence macros exist and no more. There is no separate 'templates' macro. Templates are library assets, consumed either by copying into the document macro (a snapshot that then diverges) or by pointing the reference macro at one (a live link).
* Markdown assets never get a thumbnail or preview anywhere. By design.

---

## Limits that apply here

* Library import truncation

---

## Related

[Catalogue sectionsAnother part of how this works.](https://help.gocapable.com/markdown/catalogue-sections.html)

[Template librariesAnother part of how this works.](https://help.gocapable.com/markdown/template-libraries.html)

[How it worksThe rest.](https://help.gocapable.com/markdown/how-it-works.html)

---

_How it actually behaves._