md2confluence-mcp

Upload Markdown to Confluence at SPACE ROOT level or UPDATE existing page.

⚠️ ROUTING RULES:

• Page URL provided → UPDATES that existing page (ignores parentId)

• Space key/URL only → Creates NEW page at space root level

❌ DO NOT use this tool to create child/sub-pages. ✅ Use 'create_child_page' tool instead for hierarchical pages.

Mermaid diagrams are auto-converted to images.

Update an existing Confluence page with Markdown content

List available Confluence spaces. NOTE: Do NOT use this before upload_page. Only use when user explicitly asks to browse/list spaces. For uploads, ask user directly for space key or URL.

Search for Confluence pages

Sync a LOCAL file to a Confluence page. This tool reads the file directly from the filesystem.

⚠️ CRITICAL INSTRUCTIONS FOR AI:

• file_path MUST be the EXACT path specified by the user

• Do NOT infer or guess file path based on Confluence page title or URL content

• If user says "sync readme.md to URL", find "readme.md" file, NOT files matching page title

• If multiple files match, ask user to specify the exact path

• This tool handles file reading internally - just pass the path

Examples:

• User: "sync readme.md to https://..." → file_path: "/path/to/readme.md" (find readme.md)

• User: "sync /docs/guide.md to https://..." → file_path: "/docs/guide.md" (exact path)

Create a NEW page as a child (sub-page) of an existing page.

⚠️ MUST USE THIS TOOL WHEN:

• User wants to create a page "under", "below", "하위에", or "beneath" another page

• User provides a parent page URL and wants NEW content added as a sub-page

• User says "put this under [page]", "[page] 하위에 넣어줘", "add as child of [page]"

❌ WARNING: upload_page with a page URL will UPDATE that page, NOT create a child. ✅ ALWAYS use create_child_page for hierarchical page creation.