Markdown to ADF Converter

Convert Markdown content to Confluence ADF JSON structure.

2|1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/sethdford/claude-plugins --skill markdown-to-adf-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Markdown to ADF Converter
Source: https://github.com/sethdford/claude-plugins/tree/main/confluence-plugin/.claude-plugin/skills/markdown-to-adf
Command: npx skills add https://github.com/sethdford/claude-plugins --skill markdown-to-adf-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates converting Markdown content to Confluence's ADF (Atlassian Document Format), enabling seamless publishing of documentation from README files and Markdown docs.

Core Features & Use Cases

  • Headings, lists, code blocks, tables: Accurate conversion to ADF structures.
  • Confluence enhancements: Add info panels, status badges, and links in the target page.
  • Publish-ready output: Ready-to-create or update Confluence pages via API.

Quick Start

Paste Markdown content and request conversion to Confluence ADF, then publish the resulting output to a chosen Confluence space.

Frequently Asked Questions about Markdown to ADF Converter

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

FAQPage Schema
How do I convert Markdown to Confluence ADF format?

Convert Markdown to Confluence ADF by providing your Markdown content to this Skill, which transforms headings, lists, code blocks, tables, and links into Atlassian Document Format JSON structure ready for Confluence page creation or updates.

Can I publish Markdown documentation directly to Confluence?

Yes. Convert your Markdown files to ADF format using this Skill, then use the resulting JSON output with Confluence APIs to create or update pages in your chosen space without manual reformatting.

What Markdown elements does the converter support?

The converter supports headings, lists, code blocks, tables, and links. It also enables Confluence enhancements like info panels and status badges in the target page during conversion.

Do I need to manually edit the ADF output before publishing to Confluence?

No. The Skill produces publish-ready ADF JSON output that can be sent directly to Confluence APIs for page creation or updates, preserving formatting, hierarchy, and all content types from the original Markdown.

Can I convert README files to Confluence pages?

Yes. Convert README files and other Markdown documentation to Confluence ADF using this Skill, then publish them to Confluence spaces via API for seamless documentation migration.

What happens to Markdown formatting when converting to ADF?

Markdown formatting, hierarchy, and content structure are preserved during conversion to ADF JSON format, ensuring your documentation maintains visual organization and semantic meaning in Confluence.