confluence_update_page_from_markdown
Update a Confluence page using Markdown content. Converts Markdown to Atlassian Document Format (ADF) with support for Mermaid diagrams, code blocks, tables, and more.
Instructions
Update an existing page from Markdown. Converts to Atlassian Document Format (ADF) — the recommended path for modern Confluence Cloud. Renders ```mermaid code blocks natively as Mermaid diagrams (via the Confluence Mermaid app). Supports headings, bold/italic/strikethrough, links, images (as external media), ordered/unordered lists, tables, blockquotes, code blocks with syntax highlighting, inline code, and horizontal rules. For large documents, use markdownFilePath instead of markdown to avoid tool call size limits. Use confluence_update_page_from_markdown_legacy only if the target instance has ADF disabled. Output is trimmed by default (drops _links, _expandable, body content, etc.); pass full=true to receive the raw Confluence response.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | If true, bypass response trimming and return the raw Confluence API response. | |
| title | Yes | The new title of the page | |
| pageId | Yes | The ID of the page to update | |
| status | No | Page status | |
| version | Yes | The current version number (required for optimistic locking) | |
| markdown | No | The new page content in Markdown format. Supports standard Markdown including headings, bold/italic, links, images, lists, tables, code blocks (with language for syntax highlighting), and Mermaid diagrams using ```mermaid code blocks. Either this or markdownFilePath must be provided. | |
| versionMessage | No | Optional message describing the changes | |
| markdownFilePath | No | Absolute path to a Markdown file on disk. Use this instead of the markdown parameter for large documents that may exceed tool call size limits. Takes precedence over markdown if both are provided. |