DocBrancher

Your docs belong with your team.

Preview GitHub Markdown repositories, verify rewritten relative links and attachments, and publish selected pages to Confluence Cloud with version-checked conflict protection.

Direct Summary: How DocBrancher Works

DocBrancher is a GitHub-to-Confluence Cloud documentation synchronizer. Unlike single-file Markdown converters that break relative links or silently overwrite manual wiki edits, DocBrancher indexes the full repository tree in two passes, rewrites relative .md links and #anchors into native Confluence ac:link and ri:page storage macros, deduplicates image attachments via SHA-256, and requires a read-only destination preflight before publishing.

Core Capabilities & Honest Operational Boundaries

Available in Interactive Workbench

  • Live GitHub repository branch preview (up to 20 Markdown files per scoped run)
  • Two-pass relative Markdown link and heading anchor rewriting
  • Reviewed publishing plans with read-only destination preflight
  • Human-edit conflict detection with side-by-side comparison
  • One-click standalone HTML documentation bundle export

Destination & Authentication Model

  • Uses Atlassian Forge installation or OAuth 2.0 (3LO) destination binding
  • Never collects personal Atlassian API tokens or raw passwords
  • Supports read-only destination inspection before enabling writes
  • Assisted publishing pilot available for engineering teams

Engineering Guides

How to Publish Multi-File GitHub Markdown to Confluence Cloud

Architecture guide covering two-pass link resolution, SHA-256 attachment fingerprinting, and preflight conflict gates.

Rewriting Relative Markdown Links & Heading Anchors

Technical walkthrough of POSIX path normalization, ac:link Storage XHTML generation, and collision-safe attachment naming.