markdown-confluence.com

What It Is

Markdown Confluence Tools is a suite of tools for converting Markdown content into Atlassian Document Format (ADF) and publishing it to Confluence. Rather than being a single plugin, it includes an Obsidian plugin, npm CLI, Docker CLI, GitHub Action, and npm library, making it suitable for connecting local Markdown/Obsidian documentation workflows to an enterprise Confluence knowledge base.

Core Features and Ecosystem

In terms of feature coverage, it focuses on semantic conversion from Markdown to Confluence and orchestration of the publishing process. It supports common Markdown elements such as headings, lists, tables, blockquotes, code blocks, inline code, bold/italic text, strikethrough, and horizontal rules. It also supports capabilities commonly used in Obsidian workflows, including Wikilinks, Folder Note, Callouts, and YAML Frontmatter. Images are uploaded as Confluence page attachments, with MD5 checks used to detect content changes and avoid duplicate uploads. Since Confluence does not natively support Mermaid, Mermaid diagrams are rendered as PNG files before being uploaded. Comment handling is also relatively refined: the tool attempts to reattach comments to their original positions using exact matching and Levenshtein distance.

For integrations, it is built around Atlassian Confluence, ADF, Obsidian, Docker, GitHub Actions, npm, and Mermaid.js. Configuration can come from defaults, static objects, environment variables, JSON configuration files, and command-line arguments, and can be merged automatically, making it practical for reuse across both local and CI environments.

Pricing and Open-Source Information

The captured text does not provide pricing, commercial plans, or payment method information. The documentation mentions a GitHub organization, a mono repo, and an editable documentation repository, but it does not clearly state a license or open-source declaration, so its open-source status cannot be confirmed.

Pros and Cons

Its strengths are the variety of publishing entry points: it can be used inside Obsidian, or automated via CLI, Docker, or GitHub Actions. It also pays considerable attention to Confluence publishing details such as page hierarchy, attachments, Labels, and page IDs. The downsides are that not all Obsidian features are currently supported; Wikilinks can only link to files that are being published; nested Callouts are not supported; uploaded images and rendered Mermaid diagrams cannot yet be automatically deleted from Confluence; and Mentions still require manually looking up user IDs.

Who It’s For and Access from China

It is well suited to technical teams, developer relations teams, internal knowledge base maintainers, and organizations that already write documentation in Obsidian/Markdown but need to consolidate it into Confluence. Access from China is not discussed in the source text, so users should test access to markdown-confluence.com, GitHub, npm, and Atlassian services in their actual environment. Network stability for Atlassian, GitHub, and npm, as well as enterprise payment methods, may affect deployment. Alternatives include Confluence’s native editor, self-built scripts that call the Confluence REST API directly, or other Obsidian/Confluence sync plugins.