# 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

. | | 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 [How it worksWhy they behave as they do.](https://help.gocapable.com/markdown/how-it-works.html) [TroubleshootingWhen one does not work.](https://help.gocapable.com/markdown/troubleshooting.html) --- _What people actually do._