Agent skill
confluence-to-md
Confluence to Markdown conversion skill - Properly handles draw.io diagrams, images, code blocks, and tables
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/confluence-to-md
SKILL.md
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.
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?