skills.rest
jimweller
jimwellerCOMMUNITY
Explore all skills by this author →
GitHub

confluence-authoring

Convert styled markdown into Confluence ADF draft pages via REST API.

2|Updated Feb 14, 2026
Search Tags:#documentation#markdown#knowledge base#content creation#confluence#adf
One-click install
npx skills add https://github.com/jimweller/davit-dataops-dotfiles --skill confluence-authoring
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: confluence-authoring
Source: https://github.com/jimweller/davit-dataops-dotfiles/tree/main/dataops-plugin/skills/confluence-authoring
Command: npx skills add https://github.com/jimweller/davit-dataops-dotfiles --skill confluence-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of new Confluence pages using a styled markdown format, which is then automatically converted into Confluence's native ADF (Atlassian Document Format). It streamlines content creation for documentation and knowledge bases.

Core Features & Use Cases

  • Styled Markdown to ADF Conversion: Write content in a familiar markdown syntax with specific Confluence styling conventions, and have it automatically converted to ADF.
  • Draft Creation: Pages are created as drafts, allowing for human review and editing before publishing.
  • Structured Content: Supports metadata tables, tables of contents, callout boxes, headings, status lozenges, and more, ensuring consistent and professional page formatting.
  • Use Case: A technical writer needs to create a new service documentation page. They can write the content in markdown, including metadata, a TOC, and formatted sections, and use this Skill to generate a draft page in Confluence for review.

Quick Start

Use the confluence-authoring skill to create a new Confluence page titled "My New Service" in space "SPACE_ID" with the provided markdown content.

Frequently Asked Questions about confluence-authoring

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

FAQPage Schema
How do I create Confluence pages from markdown?▼

You can create Confluence pages from markdown by using a tool that converts styled markdown into Atlassian Document Format (ADF). This process automatically generates a new page as a draft for review, supporting structured elements like tables of contents and callouts.

Does the markdown to ADF conversion support callouts and metadata tables?▼

Yes, markdown to ADF conversion supports structured content elements including metadata tables, callout boxes, tables of contents, status lozenges, and various heading styles. This ensures consistent and professional page formatting in the generated Confluence drafts.

Can I publish Confluence pages directly or do they get created as drafts?▼

Confluence pages are created as drafts, allowing for human review and editing before publishing. This draft creation workflow ensures that converted markdown content can be verified directly in Confluence before it goes live.

What is Atlassian Document Format (ADF) and why is it needed for Confluence content creation?▼

Atlassian Document Format (ADF) is Confluence's native structured JSON format needed for programmatic content creation. Converting styled markdown to ADF allows automated tools to generate complex documentation pages with proper formatting, metadata, and structural elements.

How do I automate knowledge base content creation in Confluence using REST API?▼

You can automate knowledge base content creation by running a bash script wrapper that calls the Confluence REST API. This script processes styled markdown and uses a JavaScript converter to transform it into ADF, generating new documentation pages automatically.

Are there limitations to using styled markdown for Confluence documentation?▼

Limitations include relying on specific styled markdown conventions to properly generate ADF structures. Content must be created as drafts for review before publishing, and the markdown styling must strictly match the supported syntax for elements like callouts and status lozenges.

Related Skills

Explore More Content & Communication Skills→
ericfisherdevericfisherdev
1

create-blog-post

Create Confluence blog posts from markdown or HTML content with labels.

Community
Intermediate
leolionartleolionart
1

confluence-publishing

Publish Markdown content to Confluence with synchronized metadata and formatting.

Community
Advanced
retranretran
34

confluence

Search and fetch Confluence pages in markdown or metadata format.

Community
Intermediate
jpoutrinjpoutrin
14

atlassian-attachments

Attach files to Jira issues and Confluence pages via the Atlassian REST API.

Community
Intermediate