7nohe/Confluence MD
Convert Markdown (GFM) to Confluence Cloud storage format and update a page
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 26, 2026
- License
- MIT
Pinned Snippet
uses: 7nohe/confluence-md@b94f5ef70635d3d3124972e949fc034bf6a4ca56 # v0.2.2tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| confluence_base_url | Confluence base URL (e.g., https://example.atlassian.net) | yes | — |
| page_id | Confluence page ID (fallback if frontmatter missing) | no | — |
| space_key | Confluence space key (creates new page if no page_id) | no | — |
| parent_page_id | Parent page ID for new pages | no | — |
| write_page_id | Write created page ID back to frontmatter | no | true |
| Confluence account email | yes | — | |
| api_token | Confluence API token | yes | — |
| source | Markdown file or directory path | yes | — |
| attachments_base | Base directory for resolving relative image paths (defaults to source directory) | no | — |
| title_override | Override page title | no | — |
| frontmatter_page_id_key | Frontmatter key used to extract the page ID | no | confluence_page_id |
| image_mode | Image handling mode: upload or external | no | upload |
| download_remote_images | Download remote images and upload as attachments | no | false |
| mermaid_macro | Macro name emitted for mermaid code fences. Set to match the Mermaid app installed in your Confluence site (e.g. mermaid-cloud). | no | mermaid |
| skip_if_unchanged | Skip update when storage output is identical | no | true |
| exclude | Glob patterns to exclude files in directory mode (comma or newline separated, e.g., "**/README.md,docs/draft/**") | no | "" |
| dry_run | Build output but do not update Confluence | no | false |
| notify_watchers | Accepted but currently ignored | no | false |
| user_agent | HTTP user agent | no | confluence-md |
Outputs
| name | description |
|---|---|
| page_url | URL of the updated Confluence page |
| page_id | ID of the updated Confluence page |
| version | New version number of the page |
| updated | Whether the page was actually updated (true/false) |
| created | Whether a new page was created (true/false) |
| attachments_uploaded | Number of attachments uploaded |
| content_hash | Hash of the generated storage content |
| total_files | Total number of Markdown files processed in directory mode |
| succeeded_files | Number of files processed successfully in directory mode |
| failed_files | Number of files that failed in directory mode |
| updated_files | Number of files updated in directory mode |
| attachments_uploaded_total | Total number of attachments uploaded in directory mode |
| results_json | JSON array of per-file results in directory mode |
| failures_json | JSON array of per-file failures in directory mode |
| skipped_files | Number of files skipped (no page ID) in directory mode |
| skipped_json | JSON array of per-file skipped entries in directory mode |