Common tasks
Rather than a tour, this is the list of things people do, with the route to each.
#What you can do
Task | Where | Notes |
|---|---|---|
Add a markdown document to a page | Confluence editor → /Markdown (Capable) [Sui | Opens the full-screen 'Configure Markdown' picker. Choose Markdown from scratch, Markdown from URL, Markdown from file, Studio (Suite only), or a template, then Save. An unconfigured macro s |
Write or edit the document body | The macro's Configure action, the maximize b | Three-mode editor (edit / split / preview) with a formatting toolbar and an Insert (+) menu. Edits are held locally until you press Save. |
Show a border and a title on the macro | Configure Markdown → 'Show border' checkbox | The title strip only appears when the border is on. Both fields cap at 50 characters. |
Point a macro at a README on GitHub, GitLab or Bitbucket | Configure Markdown → Markdown from URL | Paste the normal web URL. It is rewritten to the raw file automatically, and a bare github.com/owner/repo resolves to README.md on the default branch. The page follows the file rather than c |
Render a markdown file that is attached to the page | Configure Markdown → Markdown from file | Pick an existing attachment or drop a .md, .markdown, .mdx or .txt file onto the dropzone to attach and select it in one step. |
Import a markdown file from your computer | Configure Markdown → Markdown from scratch → | .md, .markdown, .mdx, .txt. Content is appended after existing text; the filename seeds an empty title. |
Insert an image or diagram from the Capable library | Editor toolbar → + → Image 'From library' or | Suite only. Inserts a reference, so the page always shows the library asset's current version. Only library images can be picked. Attachments and stock results are refused. |
Upload or paste an image into the document | Editor toolbar → + → Image 'From upload', pa | Only works while editing on a real page. The file becomes a page attachment. Not available when editing a library template. |
Draw a diagram inline | Editor toolbar → + → Diagram 'From code', th | Any of the 27 Kroki fence languages renders as a picture; Mermaid C4 is converted to PlantUML C4 automatically. |
Reuse one markdown document across many pages, kept in sync | Confluence editor → Markdown reference (Capa | Pick a space or global template with the 'Markdown Template' picker. Editing the template updates every page that references it. Use the document macro instead if you want a page-local copy |
Turn a library template into a macro by pasting a link | Capable Markdown catalogue → a template's sh | The pasted URL auto-converts into the reference macro. Not offered for the bundled Examples. |
Save a document to the shared library | Capable Markdown page → Templates → Space te | Requires a unique title and some content. The Create button is disabled with an explanatory tooltip when you lack permission or the Capable storage is still being prepared. |
Turn markdown that lives on a page into a reusable template | Capable Markdown page → open the page-owned | Both make a copy; the original stays on its page. Imported titles are truncated to 128 characters and descriptions to 250. |
Organise the library into folders | Capable Markdown page → Templates → drag doc | Folder assignment is also editable from the document's details panel, for templates not attached to a page. |
See earlier versions of a document | Capable Markdown page → open the document → | Clicking an entry loads that version into the editor as an unsaved change; save to make it the newest version. It is not a restore. |
Find which pages use a template | Capable Markdown page → open the template → | Lists pages five at a time. Counts only pages that embed it via the Markdown reference macro, and only after the page has been indexed. |
Generate a document with AI | Capable Markdown page or the insert modal → | Type a prompt, or /page to write from the current page. Suite only, and only when AI is enabled for the site. |
Open a document full screen from the page | Hover the rendered macro → maximize button | Page-stored documents open the full editor view; URL- and attachment-sourced documents open a read-only preview instead. |
Browse every markdown document on the site | Capable Markdown global page, or the space p | Sections for markdown on pages, space templates, global templates and the 17 bundled examples. Grid, list and table views. |
See the markdown on the page you're reading | Capable Search side panel → 'Markdown' panel | The byline reads 'N markdown' once the page has been indexed. |
Publish markdown to a static site | Capable Sites (Suite or the Sites app) | Both macros export as rendered HTML with images downloaded locally. Diagram fences come out as code blocks. The document title and the referenced template title both become an <h2>. |
Export a page containing markdown to Word or PDF | Confluence page → Export | Suite only, and the document macro comes out as a fenced code block of raw markdown. The reference macro contributes nothing. Use a Capable Site for a rendered result. |
Hide markdown from the whole site | Capable global settings → Capabilities tab → | Removes the nav and byline entries only; existing macros on pages keep rendering. |
Control markdown per space | Space settings → Space Capability Settings → | Space admin only, Suite only. |
Turn AI off | Capable global settings → Features tab → AI | Removes the Studio section from the markdown catalogue. |
Control who can edit shared markdown templates | Capable global settings → Permissions tab | Site admin only, and it governs the whole global asset store shared with diagrams, images, calendar and search. Not markdown alone. |
#A few things worth knowing
Some tasks need an administrator. The Where column says so.
Anything relying on search needs the page to have been indexed first.
Macro names differ slightly between the standalone app and the suite.
#Related
What people actually do.
