Maintainer for the Confluence Builder Sphinx extension. Over the years, been trying to support the various API, macro and editor changes. With respect to the editor, the extension currently defaults to producing `v1` editor content due to a subset of additional Sphinx features that can be rendered versus when using the newer editor. The extension provides a means to use the `v2` editor for users who do not require features that may be impacted by the switch. I imagine over time, we will be adjusting the extension to default to `v2` for Confluence Cloud targets when required.
If it helps, the following lists known limitations when attempting to render Sphinx-capabilities. To my knowledge, the following is up-to-date as of 2025-06-30.
- Confluence does not support applying a code line offset (v1, v2).
- Confluence does not support disabling code lines (see above ref).
- Enumerator lists do not support explicit styling (v1, v2).
- Images cannot be inlined with expected sizes (v1, v2). While changes in CONFCLOUD-68501 looked to address this, later changes made inlined images to have a non-configurable height-restricted to a line.
- Confluence does not support indenting block types. For example, an indented paragraph with a list will always have the list rendered without an indentation (v1, v2).
- Confluence does not allow image offset alignments in a paragraph (v1, v2).
In addition, not having the ability to disable table borders prevents emulating certain unique structures (e.g. horizontal lists).
I am not sure if any of these may be part of any existing roadmaps or are not part of Atlassian's goals for support in the new editor. This post is mainly for informational sake.
