markdown-confluence-sync

Synchronize local Markdown documents with Confluence pages bidirectionally.

8|2|Updated Jul 13, 2015

Search Tags:#workflow #documentation #markdown #publish #sync #confluence #crawl

Ready to run

npx skills add https://github.com/tstapler/dotfiles --skill markdown-confluence-sync

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: markdown-confluence-sync
Source: https://github.com/tstapler/dotfiles/tree/main/.claude/skills/markdown-confluence-sync
Command: npx skills add https://github.com/tstapler/dotfiles --skill markdown-confluence-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates the process of publishing, crawling, and syncing Markdown content with Confluence by providing a single CLI-driven interface and workflow.

Core Features & Use Cases

Bidirectional sync between local Markdown and Confluence pages, including publishing, crawling, and conflict resolution.
Automatic page hierarchy mapping, link resolution, and version-aware updates to keep content consistent.
Use cases include publishing project documentation, synchronizing knowledge bases, and crawling Confluence content back into Markdown for offline work.

Quick Start

Publish a local markdown project to Confluence and keep pages synchronized with on-demand crawls and conflict resolution.

Frequently Asked Questions about markdown-confluence-sync

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

FAQPage Schema

How do I sync local Markdown documents with Confluence pages?▼

You can publish local Markdown to Confluence by configuring environment variables for Confluence access and a .markdown-confluence.json file, then running the markdown-confluence CLI to execute the publish operation and maintain page hierarchy.

Can I crawl Confluence content back into Markdown for offline work?▼

The crawling process maps Confluence page hierarchies into local Markdown structures and resolves internal links, ensuring the offline content mirrors the online space accurately.

What do I need to set up before publishing Markdown to Confluence?▼

This configuration enables automatic page hierarchy mapping and version-aware updates, preventing duplicate pages and maintaining structural consistency across the targeted Confluence spaces.

How are conflicts resolved during bidirectional Markdown and Confluence sync?▼

By using version-aware updates, the system detects when a Confluence page or local document has changed independently, allowing you to execute specific conflict resolution commands to merge or overwrite content safely.

Does this Markdown Confluence sync tool manage page hierarchy and links?▼

This automatic mapping ensures that nested Markdown files become properly nested Confluence pages, maintaining the logical flow of project documentation and knowledge bases without manual restructuring.