confluence-to-md

Convert Confluence pages to Markdown files with timestamps and page titles.

11|Updated Mar 12, 2023
One-click install
npx skills add https://github.com/i9wa4/dotfiles --skill confluence-to-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence-to-md
Source: https://github.com/i9wa4/dotfiles/tree/main/dot.config/claude/skills/confluence-to-md
Command: npx skills add https://github.com/i9wa4/dotfiles --skill confluence-to-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Confluence pages often contain rich formatting that doesn't port well to Markdown. This skill converts pages to Markdown, preserving lists, images, draw.io diagrams, code blocks, and tables.

Core Features & Use Cases

  • Full-page conversion: Maintains bullet lists and nested structures.
  • Media handling: Converts embedded diagrams and images to proper Markdown links.
  • Output quality: Improves portability for docs outside Confluence.

Quick Start

confluence-to-md.py <confluence_url> or run in interactive mode to paste URL for conversion.

Frequently Asked Questions about confluence-to-md

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

FAQPage Schema
How do I convert Confluence pages to Markdown?

Converting Confluence to Markdown preserves formatting by extracting page content and reformatting it as clean Markdown files. Run confluence-to-md.py with your Confluence URL or paste the URL in interactive mode to generate timestamped output files maintaining lists, images, diagrams, code blocks, and tables.

Does Confluence to Markdown conversion handle embedded images and diagrams?

Yes, the conversion handles embedded images and draw.io diagrams by resolving full URLs and converting them to proper Markdown link syntax. This ensures diagrams and images remain accessible in the output Markdown files.

Can I preserve nested lists and code blocks when converting from Confluence?

Nested list and code block preservation is built into the conversion. The tool maintains hierarchy in bullet structures and keeps code blocks formatted as Markdown code fences, ensuring your documentation structure transfers cleanly.

What output format does Confluence to Markdown produce?

The conversion generates standalone Markdown files named with a timestamp and the original page title. Output includes normalized table formatting, resolved media links, and full content in a portable, documentation-ready format.

Why convert Confluence pages to Markdown instead of staying in Confluence?

Markdown offers better portability across tools and platforms, easier version control integration, and simpler plain-text editing. Converting enables you to move documentation outside Confluence while preserving structure and media references.