sphinx-confluencebuilder-bridge 2026.8.16

Installation

sphinx-confluencebuilder-bridge is compatible with Python 3.11+.

$ pip install sphinx-confluencebuilder-bridge

Setup

Add the following to conf.py to enable the extension:

"""Configuration for Sphinx."""

extensions = ["sphinxcontrib.confluencebuilder"]  # Example existing extensions

extensions += [
    # This must come after ``"sphinxcontrib.confluencebuilder"``
    "sphinx_confluencebuilder_bridge"
]

Supported directives

Only some of the directives supported by Atlassian® Confluence® Builder for Sphinx are supported. The following directives are supported:

• confluence_toc

  • The only supported option is max-level.

• confluence_viewpdf

  • HTML output builders only (e.g. html, dirhtml, singlehtml).

  • Requires the PDF to be in a directory specified in html_static_path.

Supported roles

Only some of the roles supported by Atlassian® Confluence® Builder for Sphinx are supported. The following roles are supported:

• confluence_link

  • This renders as a normal hyperlink, unlike in Confluence where the page title is shown.

• confluence_doc

  • This renders as a normal documentation link, unlike in Confluence where the page title is shown.

• confluence_mention

  • This renders as a link with the text being the user’s account identifier, user key or username.

  • For this to show a clear account identifier, set confluence_mentions in conf.py.

Contributing

See CONTRIBUTING.rst.