Preview and Export Multi-File GitHub Markdown as an HTML Bundle Before Confluence Publishing
Updated
1. Load a Public GitHub Repository in the Interactive Workbench
Open /app (or click the pre-configured sindresorhus/ky demo link below) to fetch up to 20 Markdown files (.md, .markdown, .mdx) from the repository root and docs/ directory. Pass 1 indexes every discovered Markdown file and heading anchor; Pass 2 compiles GitHub-Flavored Markdown tables, fenced code blocks, and relative file links into structured Confluence preview output.
Repository coordinate: sindresorhus/ky (branch: main)
Scoped discovery limit: Up to 20 Markdown files (.md, .markdown, .mdx) across root and docs/
Pass-1 index: Maps repository file paths + heading slugs to deterministic page targets
2. Export an Offline HTML Bundle via "Download HTML bundle"
In the workbench top bar, click the "Download HTML bundle" button. In public repository preview mode, the workbench builds a multi-page HTML bundle directly in your browser session and downloads a standalone .html file containing a sidebar table of contents, compiled headings, GFM tables, code blocks, and rewritten internal page anchors.
Workbench Action: Click "Download HTML bundle" in the workbench header
Downloaded File: docbrancher-bundle-<timestamp>.html
Included Sections: Navigation index + compiled HTML sections for each selected Markdown file in scope
3. Public Preview Asset Boundary vs Authorized Workspace Export
Some repository images are not included in public-preview exports. In public repository preview mode, only built-in sample workspace assets are embedded inline, so external or unbundled repository binary images are not embedded inline as data URIs during anonymous preview. Compiled headings, GFM tables, code blocks, and rewritten internal page links are fully included in the downloaded HTML bundle.
Frequently Asked Questions
Does clicking "Download HTML bundle" in public preview mode require a Confluence login?
No. Public repository preview builds the multi-page HTML bundle locally in the workbench when you click "Download HTML bundle". Checking or publishing to a live Confluence space requires an authorized Confluence connection.
How are binary images handled in public repository HTML bundle exports?
Some repository images are not included in public-preview exports. In public repository preview mode, only built-in sample workspace assets are embedded inline; external or unbundled repository binary images are not embedded inline during anonymous public preview.
Related DocBrancher Guides & Compatibility Reference
-
Technical Compatibility, Scope & Explicit Non-Goals Matrix
Reference table covering the 20-file scoped run limit, supported GFM syntax, and preflight version check boundaries.
-
How to Publish Multi-File GitHub Markdown to Confluence Cloud Without Broken Links
Step-by-step engineering guide to synchronizing multi-file GitHub Markdown trees, relative links, anchors, and binary image attachments to Confluence Cloud.
-
Rewriting Relative Markdown Links and Heading Anchors for Confluence Storage XHTML
Technical reference on converting GitHub-Flavored Markdown relative paths, directory traversal links, and #heading-anchors into native Confluence Cloud macros.
-
Publish GitHub Markdown to Confluence While Checking for Manual-Edit Conflicts
Learn how to synchronize GitHub Markdown repositories to Confluence Cloud with read-only preflight version checks and side-by-side manual-edit conflict resolution.
Preview a Public Repository or Request an Assisted Pilot
Preview rendered pages and rewritten links using a public GitHub repository. The illustrated conflict example explains version checks; checking your destination requires an authorized Confluence connection.