Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Sphinx extension to output Atlassian Confluence Wiki files and publish to Confluence Servers.

Project description

pip Version Build Status Documentation Status

Sphinx extension to build Confluence Wiki markup formatted files and optionally publish them to a Confluence instance.


If publishing:


The recommended method to installing this extension is using pip:

pip install sphinxcontrib-confluencebuilder

For a more in-depth installation information, see also:

Atlassian Confluence Builder for Sphinx - Installation


  • Set the builder sphinxcontrib.confluencebuilder in the as an extension in
extensions = ['sphinxcontrib.confluencebuilder']
  • Run sphinx-build with the builder confluence:
sphinx-build -b confluence _build/confluence -E -a
python -m sphinx -b confluence . _build/confluence -E -a

For more information on the usage of this extension, see also:

Atlassian Confluence Builder for Sphinx - Tutorial


The following is an example of simple configuration for Confluence generation and publishing:

extensions = ['sphinxcontrib.confluencebuilder']
confluence_publish = True
confluence_space_name = 'TEST'
confluence_parent_page = 'Documentation'
confluence_server_url = ''
confluence_server_user = 'username'
confluence_server_pass = 'password'

For a complete list of configuration changes, see also:

Atlassian Confluence Builder for Sphinx - Configuration


The set of example documents used to assist in validation/testing can be found here:

The active and older versions of published validation documents can be found here:

Atlassian Confluence Builder for Sphinx - Online Demo on Confluence Cloud

Supported Markup

  • Bulleted Lists
  • Citations
  • Code Blocks
  • Definitions
  • Enumerated Lists
  • Footnotes
  • Headings
  • Hyperlinks
  • Indentations
  • Inline Blocks/Literals
  • Paragraphs
  • Tables
  • TOC Tree

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sphinxcontrib_confluencebuilder-0.9-py3-none-any.whl (36.8 kB) Copy SHA256 hash SHA256 Wheel py3 Jun 4, 2018
sphinxcontrib-confluencebuilder-0.9.tar.gz (32.9 kB) Copy SHA256 hash SHA256 Source None Jun 4, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page