OpenParable
Skip to content
← Back to skills

Confluence To Md

Documents
confluence-to-md

Confluence To Md is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Confluence to Markdown conversion skill - Properly handles draw.io diagrams, images, code blocks, and tables

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/documents/confluence-to-md/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/confluence-to-md, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Confluence to Markdown Skill

This skill provides functionality to convert Confluence pages to Markdown.

1. Overview

Use the bin/confluence-to-md.py script to convert Confluence pages to Markdown files.

1.1. Key Features

  • Preserve bullet list structure (prevent flattening)
  • Convert draw.io diagrams and images to full URL
  • Convert horizontal rules (<hr> -> ---)
  • Maintain code blocks
  • Improve table formatting
  • Output filename: {timestamp}-confluence-{title}.md

2. Environment Setup

2.1. Required Environment Variables

Set the following in project root .env file.

CONFLUENCE_BASE=https://your-confluence-instance.atlassian.net/wiki
[email protected]
CONFLUENCE_API_TOKEN=your-api-token

2.2. Dependencies

pip install requests beautifulsoup4 html2text python-dotenv

3. Usage

3.1. Command Line Execution

# Specify URL as argument
confluence-to-md.py <confluence_url>

# Interactive mode
confluence-to-md.py

3.2. URL Format

Extract page ID from Confluence page URL.

https://your-confluence.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title

3.3. Output Location

Converted Markdown files are saved to ~/Downloads/.

~/Downloads/20251219-123456-confluence-Page_Title.md

4. Conversion Specifications

4.1. Bullet Lists

Convert HTML <ul>, <ol> while preserving nested structure.

- Item 1
    - Sub-item 1-1
    - Sub-item 1-2
- Item 2

4.2. draw.io Diagrams and Images

Convert ac:image and img tags to full URL Markdown images.

![image](https://confluence.example.com/download/attachments/123456/diagram.png)

4.3. Code Blocks

Convert <pre> tags to Markdown code blocks.

```text
Code content
```

4.4. Tables

Format tables with aligned column widths.

| Column1 | Column2 |
| ------- | ------- |
| Data1   | Data2   |

5. Troubleshooting

5.1. Authentication Error

Error: CONFLUENCE_BASE, CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN must be set
in .env file.

Check .env file settings.

5.2. Page ID Extraction Error

Error: Could not extract page ID from URL.

Verify URL contains /pages/number/ format.