Confluence Document Editor - will they ever fix it or will it always be the worst?

Nadger119 September 21, 2018

Confluence document editor has to be the worse experience I have ever had editing a document. To mention a couple of issues:

  • Random amount of space between paragraphs - not correctable
  • If image is left aligned the text goes next to it, even if corrected in the editor it just goes back to how it was when you publish
  • Changing Formatting on one bit of text will affect the whole document
  • Headers seem to just turn back to paragraphs on their own
  • Paragraphs turn to headers on their own

Basically if you want a document to be formatted in a certain way then confluence is not the tool to use. I would go as far to say that its unusable for document editing.

After looking into this its a common issue thats been reported multiple times... Atlassian don't seem to care as they are not doing anything about it and actually advise to link to gists instead of using their editor.. why pay for confluence then? lazy devs I guess!

Anyone else had a bad experience with the document editor?

4 comments

Bill Bailey
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 23, 2018

It REALLY sounds like something is wrong in your instance.  It has always been very stable from my experience. But you have to understand that this is not a full featured editor (derived from TinyMCE). It also has to use HTML which places a lot of constraints on presentation.

I have been a long term fan of FrameMaker (the gold standard for documentation), but I fully support using Confluence for documentation because of the collaboration, then creating user macros, and custom CSS to get the look and features I need.

Tobias Anstett _K15t_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 24, 2018

I am working for a long time with Confluence and yes there were ups-and-downs using the editor (still remember the wiki-markup days)...

However I agree with Bill that as of today the Confluence editor provides a great experience and is working awesome for documentation. 

Of course it always depends - if you are looking for an Excel like table experience it won't work.

The only thing you have to be aware is copying formatted content from somewhere else will introduce some html tags you won't see in the editor but will affect it.

Best, Tobias

Bill Bailey
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 25, 2018

To add to Tobias' statement -- because of the issue of users pasting in HTML into documents (div and span tags being the bigger offenders), I strongly recommend that admins (or those responsible for documentation) install the source editor plug in. It has saved me many times, especially with its RegEx search capabilities.

Davin Studer
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 25, 2018

The only time I have seen things like that is when a document has been created by being imported from a Word document. There is often weird stuff brought into it behind the scenes that rears its ugly head when you backspace or try to clear blank lines. If you are experiencing issues like that my hunch would be that it was imported from Word. Typically when I do for stuff that needs to come from word is either use the Word macro to render the document out to a page or first copy and paste into a text editor that doesn't do any rich formatting. Then I copy and paste into Confluence and reformat it.

Bill Bailey
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 26, 2018

This is why I am a huge advocate for the confluence-source-editor. It allows me to clear out the span and div tags using RegEx in an imported document, saving a lot of reformat work. It also allows me to get rid of the spasmodic double spaces after periods. ;-)

Sinclair October 1, 2018

Am right there with you @Nadger119 - cut and paste issues are the bane of my existence. And call me provincial but as lovely as a plugin source editor might be, it feels a bit tricksy to have to install an external tool to fix something going wrong in the built-in editor.

:D

Like Joel likes this
Rusty Colbert August 31, 2023

Wow, I cannot believe there are people who like this editor. I think this must be your primarey editor :-).  There is nothing intuitive if you have used any other editor aside from the horrible wiki editor. I am a developer, who is asked to update pages now and then with my observations/findings. It is always a bad experience. If I have to create a new page of any complexity, I would create it in word and then import. Again, it is the worst editor I have to periodically use. I have used word, wordperfect, notepad, framemaker, etc over the years and this and the wiki editor are just the worst. (and I guess that is a personal opinion)

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events