obsidian-publish-confluence 0.1.4

Publish Obsidian Markdown notes to Confluence over Kerberos

obsidian-publish-confluence

Publish Obsidian-flavored Markdown to Confluence over Kerberos.

Versioning is derived from Git tags for releases.

Features

• Create or update Confluence pages from Markdown.
• Track markdown -> page_id mappings locally.
• Upload attachments on both page create and update.
• Convert Obsidian image embeds like ![[image.png]] and ![[image.png|400]].
• Convert fenced code blocks to Confluence code macros.
• Convert PlantUML blocks to the native Confluence plantuml macro.
• Support --dry-run to inspect conversion and publish actions without changing Confluence.

Requirements

• Python 3.10+
• curl
• kinit and klist
• A Confluence instance that accepts Kerberos auth via curl --negotiate

Installation

pip install obsidian-publish-confluence

For local development:

python -m pip install -e .

Configuration

Set these environment variables:

• OBSIDIAN_PUBLISH_CONFLUENCE_BASE_URL
• OBSIDIAN_PUBLISH_CONFLUENCE_SPACE
• OBSIDIAN_PUBLISH_CONFLUENCE_PARENT_ID
• OBSIDIAN_PUBLISH_CONFLUENCE_MAPPING_FILE (optional)

Defaults:

• OBSIDIAN_PUBLISH_CONFLUENCE_MAPPING_FILE defaults to ~/.config/obsidian-publish-confluence/mapping.json

Usage

export OBSIDIAN_PUBLISH_CONFLUENCE_BASE_URL="https://confluence.example.com"
export OBSIDIAN_PUBLISH_CONFLUENCE_SPACE="DOCS"
export OBSIDIAN_PUBLISH_CONFLUENCE_PARENT_ID="123456"

obsidian-publish-confluence note.md
obsidian-publish-confluence note.md --title "Custom title"
obsidian-publish-confluence note.md --space DEV --parent-id 987654
obsidian-publish-confluence note.md --dry-run
obsidian-publish-confluence --check

--dry-run converts the note, prints the intended action and attachment list, and skips Confluence API calls.

Kerberos

The CLI expects a valid Kerberos ticket:

kinit [e-mail]

PlantUML

PlantUML fenced blocks are converted to the native Confluence plantuml macro.

This requires a Confluence instance with a compatible plantuml macro installed.

Release versioning

The package version comes from the Git tag used for the release. For PyPI releases, create a tag like v0.1.0 before publishing a GitHub Release.

Limitations

• Only image-style Obsidian embeds are converted to Confluence attachments.
• Attachment names are namespaced automatically to avoid collisions between files with the same basename.
• Numeric Obsidian image suffixes like ![[image.png|640]] become Confluence image widths.
• Non-image wiki links stay plain text.
• PDF embeds are not converted.
• Auth mode is Kerberos-only.
• If a note is not already tracked in the mapping file, a new Confluence page is created instead of matching an existing page by title.
• PlantUML publishing depends on the Confluence-side plantuml macro being available.

Publishing

This repository includes GitHub Actions for:

• building distributions on push and pull request
• publishing to PyPI on GitHub Release published

PyPI publishing is configured for Trusted Publishing.