Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Convert restructuredText to Confluence style wiki.
Python Shell
branch: master

This branch is 39 commits ahead of kenichiro22:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Convert reStructuredText to Confluence markup

Supported directives

  • bullet list
  • enumerated list
  • image, figure, confluence image galleries
  • definition list
  • simple and grid tables
  • block quote
  • text effect
    • strong
    • emphasis
    • monospace
  • code blocks
  • links
  • admonitions
    • info
    • note
    • tip
    • warning
  • field lists
  • line blocks (except nested ones)
  • meta directives
  • substitutions

Additional features

Image galleries

Images and figures with class names that begin with gallery- form a gallery:

.. image:: cat.jpg
    :class: gallery-1
.. image:: dog.jpg
    :class: gallery-1
.. figure:: horse.jpg
    :class: gallery-2
    :scale: 50%

This creates two galleries: One with cat and dog, the other one with the horse picture only. All attributes are ignored on gallery images.

Gallery-classed images are converted to {gallery:include=a.jpg,b.jpg} Confluence markup.


./ /path/to/file.rst


From git checkout:

$ sudo ./ install

Without a git checkout:

$ pip install rst2confluence


  • python-docutils


We have some examples how rst2confluence should behave.

Check if it does what it should:


Run a single test:

./ test/figure.rst

Other tools

Use deploy-rst to automatically deploy rST documents into confluence.

Releasing a new version

  1. Fill ChangeLog

  2. Update version in

  3. Create release tag

  4. Upload to pip:

    $ ./ sdist upload
Something went wrong with that request. Please try again.