fmnapoli/md2confl repository overview

⁠md2confl

Convert Markdown files to Atlassian Document Format (ADF)⁠ and publish directly to Confluence Cloud.

⁠Features

• Markdown → ADF — Full GFM support (tables, strikethrough, autolinks)
• Publish to Confluence — Create/update pages via REST API v2
• Mermaid diagrams — Pre-rendered to SVG (Node.js + Chromium + mmdc included)
• Directory sync — Map folder hierarchies to Confluence page trees
• Idempotent updates — Page ID markers for safe re-publishing
• Local images — Auto-uploaded as attachments

⁠Quick Start

⁠Convert to ADF (stdout)

docker run --rm -v "$(pwd):/workspace" fmnapoli/md2confl --input doc.md

⁠Publish to Confluence

docker run --rm -v "$(pwd):/workspace"   -e CONFLUENCE_URL="https://site.atlassian.net"   -e CONFLUENCE_EMAIL="[email protected]"   -e CONFLUENCE_TOKEN="your-api-token"   fmnapoli/md2confl --input doc.md --publish --space DEVOPS --title "My Page"

⁠Publish with Mermaid diagrams

Mermaid blocks are automatically rendered to SVG — no extra setup needed:

docker run --rm -v "$(pwd):/workspace"   -e CONFLUENCE_URL="https://site.atlassian.net"   -e CONFLUENCE_EMAIL="[email protected]"   -e CONFLUENCE_TOKEN="your-api-token"   fmnapoli/md2confl --input doc.md --publish --space DEVOPS --title "My Page"

⁠Supported Platforms

• linux/amd64
• linux/arm64

⁠Links

• GitHub⁠
• Documentation⁠
• Releases⁠