confluence

Convert Markdown to Confluence storage format and manage attachments.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/beauschwab/airflow-dbt-datahub --skill confluence-beauschwab
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: confluence
Source: https://github.com/beauschwab/airflow-dbt-datahub/tree/main/.agents/skills/confluence
Command: npx skills add https://github.com/beauschwab/airflow-dbt-datahub --skill confluence-beauschwab

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires mistune, md2cf, PyYAML, requests, markdownify, confluence_auth, beautifulsoup4, atlassian-python-api, python-dotenv, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Manages Confluence documentation by providing downloads, uploads, conversions, and diagrams, reducing manual effort and ensuring consistent page structure.

Core Features & Use Cases

  • Downloads Confluence pages to Markdown with frontmatter metadata and optional attachments.
  • Uploads Markdown back to Confluence as storage-format content, handling attachments and diagrams (including Mermaid/PlantUML rendered images).
  • Converts between Markdown and Confluence Wiki Markup, and renders diagrams for inclusion in pages.
  • Use Case: A team migrates a documentation set to a new Confluence structure, automating page creation, content updates, and image attachments while preserving hierarchy.

Quick Start

Place a Confluence Markdown file in your project and trigger the skill to download, upload, or convert pages and diagrams.

Frequently Asked Questions about confluence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to Confluence storage format and upload pages?โ–ผ

To convert Markdown to Confluence storage format and upload pages, use md2cf alongside the atlassian-python-api client to publish content while handling attachments and preserving hierarchy.

Can I download Confluence pages to Markdown with metadata?โ–ผ

Yes, you can download Confluence pages to Markdown with frontmatter metadata and optional attachments, enabling local editing and version control of your documentation.

Does this approach support rendering Mermaid and PlantUML diagrams for Confluence?โ–ผ

Yes, it supports rendering Mermaid and PlantUML diagrams into images, uploading them as attachments, and embedding them into your Confluence pages during the publishing workflow.

What's the best way to migrate a documentation set to a new Confluence structure?โ–ผ

The best way to migrate a documentation set to Confluence is automating page creation and content updates from Markdown files while preserving page structure and handling image attachments.

Do I need atlassian-python-api and md2cf to manage Confluence documentation?โ–ผ

Yes, you need atlassian-python-api for Confluence API connectivity and md2cf for converting Markdown to Confluence storage format to successfully download, upload, and convert pages.

Why does Confluence Wiki Markup conversion matter for Markdown files?โ–ผ

Converting between Markdown and Confluence Wiki Markup matters because it ensures content structure is preserved when uploading Markdown files to Confluence storage format.