How do I install the Confluence To Md skill?

Run npx skillmds add majiayu000/confluence-to-md in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Confluence To Md safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Confluence To Md?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Confluence To Md free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Confluence To Md?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Confluence To Md by majiayu000 — Agent Skill

Name: Confluence To Md
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

File contents

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
CONFLUENCE_EMAIL=your-email@example.com
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.

---name: confluence-to-mddescription: Confluence to Markdown conversion skill - Properly handles draw.io diagrams, images, code blocks, and tables--- # 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. ```sh CONFLUENCE_BASE=https://your-confluence-instance.atlassian.net/wiki CONFLUENCE_EMAIL=your-email@example.com CONFLUENCE_API_TOKEN=your-api-token ``` ### 2.2. Dependencies ```sh pip install requests beautifulsoup4 html2text python-dotenv ``` ## 3. Usage ### 3.1. Command Line Execution ```sh # 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. ```text https://your-confluence.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title ``` ### 3.3. Output Location Converted Markdown files are saved to `~/Downloads/`. ```text ~/Downloads/20251219-123456-confluence-Page_Title.md ``` ## 4. Conversion Specifications ### 4.1. Bullet Lists Convert HTML `<ul>`, `<ol>` while preserving nested structure. ```markdown - 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. ```markdown ![image](https://confluence.example.com/download/attachments/123456/diagram.png) ``` ### 4.3. Code Blocks Convert `<pre>` tags to Markdown code blocks. ````markdown ```text Code content ``` ```` ### 4.4. Tables Format tables with aligned column widths. ```markdown | Column1 | Column2 | | ------- | ------- | | Data1 | Data2 | ``` ## 5. Troubleshooting ### 5.1. Authentication Error ```text Error: CONFLUENCE_BASE, CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN must be set in .env file. ``` Check `.env` file settings. ### 5.2. Page ID Extraction Error ```text Error: Could not extract page ID from URL. ``` Verify URL contains `/pages/number/` format.

Frequently asked questions