opendocsync/ConfluenceSynkMD
Sync Markdown documents with Atlassian Confluence Cloud. Full diagram toolchain (Mermaid + Draw.io + PlantUML + LaTeX) baked into a signed multi-arch Docker image — no host installs required.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit May 5, 2026
- License
- MIT
Pinned Snippet
uses: opendocsync/confluencesynkmd@f0805dbc0adb1eba66150d13efe7632082fffb63 # v0.1.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| subcommand | Which sync direction to run: `upload` (Markdown → Confluence), `download` (Confluence → Markdown), or `local` (render to Confluence Storage Format without API calls). | yes | upload |
| path | Path to the Markdown root, relative to the workspace (e.g. `docs`). | yes | — |
| conf-space | Confluence Space Key (e.g. `DEV`). | yes | — |
| conf-parent-id | Optional Confluence parent page ID for subtree operations. | no | "" |
| keep-hierarchy | Preserve local directory structure as a parent-child page tree in Confluence. Set to `false` to flatten all pages under the root. | no | true |
| skip-update | Skip uploading pages whose content has not changed since the last run. | no | false |
| image | Override the published image reference (advanced). Default tracks the `0.1` minor channel. | no | ghcr.io/opendocsync/confluencesynkmd:0.1 |
| extra-args | Additional CLI args appended to the invocation (escape hatch). Whitespace-separated; not shell-parsed — use one CLI flag per token. | no | "" |
Outputs
no outputs