confluence_create_page_from_markdown
Create Confluence pages directly from Markdown. Converts to ADF with native support for Mermaid diagrams, code blocks, and large documents via file path.
Instructions
Create a new 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_create_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 | No | The title of the page. Optional when markdownFilePath is provided — defaults to the file's basename without the .md extension. | |
| status | No | Page status (default: current) | |
| spaceId | Yes | The ID of the space to create the page in | |
| markdown | No | The 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. | |
| parentId | No | The ID of the parent page (optional) | |
| 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. |