skills.rest
tstapler
tstaplerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/tstapler/dotfiles --skill markdown-confluence-sync
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
MercurykzMercurykz

confluence-assistant

Automates searching, creating, updating, and commenting on Confluence pages and spaces.

Community
Intermediate
TaylorHustonTaylorHuston
69

commit

Automates git commits with conventional messages across project spaces and meta-repos.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

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

Community
Intermediate
mistakeknotmistakeknot
3

interkasten

Synchronize local project directories with Notion workspaces bidirectionally.

Community
Advanced