skills.rest
NexusSema
NexusSemaOFFICIAL
Explore all skills by this author →
GitHub

confluence-sync

Synchronize Markdown files with Confluence pages bidirectionally via REST API v2.

5|3|Updated Mar 4, 2026
Search Tags:#documentation#markdown#sync#confluence#frontmatter#confluence-api#md-to-confluence
One-click install
npx skills add https://github.com/NexusSema/omg-marketplace --skill confluence-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: confluence-sync
Source: https://github.com/NexusSema/omg-marketplace/tree/main/plugins/scrum-master/skills/confluence-sync
Command: npx skills add https://github.com/NexusSema/omg-marketplace --skill confluence-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables bidirectional synchronization between local Markdown documents and Confluence pages, eliminating the manual effort of keeping both sources in sync and reducing drift between documentation in code and in Confluence.

Core Features & Use Cases

  • Push a single Markdown file to Confluence to create or update a page with frontmatter-driven metadata.
  • Pull a Confluence page back to Markdown, preserving key metadata in YAML frontmatter for future updates.
  • Batch push or pull across directories to keep large documentation repositories aligned across platforms.

Quick Start

Configure Atlassian credentials and perform a sample push to verify the integration.

Frequently Asked Questions about confluence-sync

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

FAQPage Schema
How do I sync Markdown files with Confluence pages?▼

To sync Markdown with Confluence, you use a bidirectional synchronization process that pushes single or batch MD files to create or update Confluence pages, and pulls pages back into MD with YAML frontmatter metadata.

What frontmatter fields are required to push Markdown to Confluence?▼

Pushing Markdown to Confluence requires YAML frontmatter fields like confluence_title, confluence_space_id, and confluence_parent_id, while optionally including confluence_page_id and confluence_version for updates.

Can I batch push an entire directory of Markdown files to Confluence?▼

Yes, you can batch push across directories to keep large documentation repositories aligned, updating multiple Confluence pages from Markdown files in a single operation.

What Atlassian credentials do I need to sync Markdown with Confluence?▼

Syncing Markdown with Confluence requires Atlassian credentials configured via environment variables to authenticate with the Confluence REST API v2 for page creation and updates.

Does Confluence sync preserve metadata when pulling pages to Markdown?▼

Yes, pulling Confluence pages back to Markdown preserves key metadata in YAML frontmatter, capturing details like space ID and page ID for future synchronization updates.

What are the limitations of bidirectional Markdown and Confluence sync?▼

The sync handles basic conversion between Markdown and Confluence, meaning complex Confluence page formats or macros may not fully translate when pulled back into standard Markdown files.

Related Skills

Explore More Content & Communication Skills→
magnus919magnus919
40

confluence-cli

List spaces, retrieve pages, search with CQL, and create pages via Confluence Cloud REST API v2.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
softmgsoftmg

github-workflow-automation

Automate GitHub Actions workflow generation and CI/CD pipeline management.

Official
Advanced
wulaosijiwulaosiji
28

feishu-wiki-orchestrator

Parse Markdown files into Feishu block formats and create documents in Wiki spaces.

Community
Intermediate