This documentation relates to an earlier version of Confluence.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

We're collating feedback on the new editor introduced in Confluence 4.0 here. If you have feedback on a bug, a task you now find harder or are unable to do in the new editor then please leave a comment below and we'll incorporate it into this page (and remove the comment afterwards). 

For the background on why Wiki markup was removed in Confluence 4.0, please read our blog post, Why We Removed the Wiki Markup Editor in 4.0.


Customer FeedbackAtlassian
FromCommentNotesRelated TicketsStatus
Jean-Yves Avenard, Nils Andresen, Brad Newman, Peter Burkholder, Ole Kværnø, Diego Ballve
No more editing with an external text editor where you can run quick find/replace, quickly.Having Find/Replace built into the editor is on the short term roadmap.CONF-4402 
Matt Doar (ServiceRocket)how do I change 100 URLs on a page that have a typo in their domain name?

Matt, if these are appearing as actual links (as I assume) then you'll need to edit and change the URL for each one.

Matt replied: doing that for each one really doesn't scale, and it's just one example task of many that used the ability to Wiki markup

If they're just text (not linked) you'll be able to use the Find/Replace functionality of CONF-4402 once it's released.

Andreas Pfotenhauer...imported from a trac wiki, and the importer had left some strange inline css in place, setting some padding and margins, and i was not able to remove it using the new wonderful editor, so finally i edited the page directly in the database...   
Matthias BaslerFinding bugs in the source code  is difficult or impossible since one cannot see them in the WYSIWYG editor. (This includes invisible tags that should not be there, f.e. after copying content from a word document into the page)   
Ilya Kaplunwhen i paste formatted code into the block, all the leading spaces are removed, and so i have to retab everythingFix released in v4.0.5 CONF-23564RESOLVED
AnonymousI want "insert jira issue" to be included in the autocomplete when I start with {jira, which now only shows the 'JIRA Issues' and 'JIRA Portlet' macrosJIRA ticket raised for this one.CONF-23858 
Nils AndresenIf I have a table (or a note/warning) directly followed by a heading
  • previously I simply added a new line between them
  • now placing the cursor in the table and pressing enter does create a new line - but in the table
  • placing the cursor before the heading and pressing enter creates a new heading
    • so i'll have to use the mouse to "undo" the heading - then start typing
Nils, for a quick workaround of sorts, you can use the Keyboard Shortcuts to remove (and apply) the heading so you don't need to use the mouse when using your second approach.  



Nils Andresen

In wiki markup, I just typed it. Now, I have to use shortcuts, mouse clicks, and menus. I just want to type.

I want to be able to insert or edit a macro and it's paramaters without having to touch the mouse

When inserting a macro with properties (like note:heading=...) I am currently unable to do this

Anonymous, Nils, there's a JIRA case for a proposed idea to alleviate this concern referenced, it would be great to get any feedback on this that you have.CONF-24038 
Jean-Yves AvenardAs the wiki being edited is about a mathematical tool, there's lots of use of upper/lower script and font of different size. As the feature to change the font size isn't available with confluence, we created a macro small/big like so: {small:80}text{small}. The wysiwyg is completely broken for those, the smaller sized text appears on a different line so you have to keep switching between wysiwyg mode and preview.

Jean-Yves can you provide an example of what you're trying to do and how it worked before? Is this not something that the subscript & superscript formats can do for you?

The Confluence macros that were used to markup text (like {color}) have been replaced with plain HTML. You can create a migration for you macro that will convert those macros to say "<subscript>text</subscript>". See Upgrading and Migrating an Existing Confluence Macro to 4.0.

Justin SpiesIn the past I viewed the Wiki text version, copied that text and then pasted it into a new template. How do I do so now without having to create the document twice since the template editor is not rich text, but rather is straight Wiki text?This will be addressed in the futureCONF-11744 
sanjay srikondaLinking within the same page is a nightmare in 4.0. I have to press CTL+K to bring up the link window, yet, NOTHING in that window seems to work for linking within the same page. I have to create the same link 3-4 times before it "sticks" in my page.Sanjay, I'll try and recreate this and raise a bug in JIRA for you.  
sanjay srikondaInserting graphics through the UI is buggy because sometimes it will insert a graphic just fine and the next graphic it will NOT show up or even show in my attached dialog. And, sometimes, thumbnails are not showing up for some inexplicable reason.sanjay as mentioned previously definitely sounds like a bug, did you raise a support ticket?  
Anonymous x3I often capture technical documentation in another editor before posting it to the wiki – this is in lieu of not documenting at all. What is broken is the ability to take these documents in wiki markup and work with it offline before reposting.Is the problem here then that you need to be able to work offline?  
Diego Ballvesometimes I used to copy a page away, do replacements on it using wiki syntax on text editor (say most of the page was good some paths and variables in the content had to be changed to reflect a different environment), then insert it back as new page. No can do now.use case is doing find/replace on links and variables?  
Anonymous​user macros are crippledAny more detail on this?  
Anonymouscode macro does not workAny more detail on this?  
Anonymouscopy&paste of content to and from tables is a mess

Let me know if there are still specific problems you're having but the changes to tables in 4.0.5 that are detailed in CONF-23408 will fix a lot of them I suspect.

I'll note as resolved but if anyone still has problems with this in 4.0.5 please let me know,

Anonymoussend a page by email in wiki-markup to a customer and they could update the documentationAre you able to provide any additional details of the use case behind this?  
Anonymouscopy/paste of complex layout, even on a mobile deviceWhat's the use case behind this? Not something copy page can do?  
Jean-Yves Avenardit has broken all my macrosJean-Yves do you have any specifics to provide on this?  
Nils AndresenMoving things around in lists (like this one..) by using copy & paste is horribleNils we implemented CONF-23842 in 4.0.5, love to confirm if this fixed the problems you were having?CONF-23842RESOLVED
sanjay srikondahow do I make a bulleted/numbered list with either/or in between and then continue the numbering.Sanjay, I think CONF-23899 will be the beginning of the solution to this also. The next step will be allowing bullets to be included after the delete is done. Do you think that interaction makes sense?  
Nils Andresenthe "enter insert new paragraph"-feature makes me crankyNils is this in lists (like above) or other situations also?  
eddie connatser

I created my own Editable Table macro - which relies on saving its content by doing a form post with it's content as wiki-markup and html. The fact that wiki markup isn't processed in the new wiki editor breaks this macro

AnonymousI loved being able to focus entirely on the content and not to worry about the formattingDoes Wiki Markup Styler help with this? What is it that inhibits you from writing out your document then coming back through and formatting it afterwards?  
Brad Newmanit takes several button clicks and creation of whitespace to try and paste text in cleanly or fix errors in formatting (e.g. copy plain text, paste it and have it show up as bold, press return to separate out some whitespace, paste again, etc.)Brad, I'll take a minute later to see if I can recreate this. Do you have any other specific examples of whitespace problems?  

Alex (posted Anonymously)

Matthias Basler


we do sometimes copy over parts of the text from JIRA to Confluence and back, and earlier the wiki markup mode allowed to keep text formatting fully same across both systems without any additional effort.Right now you can copy formatted text from JIRA to Confluence, if you highlight and copy it from the issue details page, not issue edit. However, this is not that handy, because you can't use Ctrl+A to actually highlight all the description text instantly. And obviously - there is no way now to copy formatted text parts from Confluence to JIRA.


One point that became important for us just now is that up to now the wiki markup allowed to easily exchange content between wikis. Since confluence 4 there's no easy way any more to just copy the content or parts of a page to a text editor, send to someone else and have it inserted into another confluence wiki.

AnonymousWe keep the sources (textile markup files) of this documentation in a VCS. If we can't export the markup, how do you suggest that we edit something, put it in Confluence and push it to the VCS?

Previous comment: Sounds very specific to your use case, but we have a remote API which allows you to convert your wiki markup to storage format. If you wanted you could write a script to simply keep updating the pages that you have from the wiki markup pages you already have in your VCS.

Does this solution help?

Anonymous[previously] different people could be working on separate pieces of a single page (article) using their own favorite editor (TextMate, e, etc.) and merging the pieces is (was) a no brainer.

Interested in more detail around why this isn't the case now?

For new content you could still write it in Wiki Markup even if you wanted to then use the Insert > Wiki Markup dialog, otherwise just format it after combining. Is there more to your use case that means that won't work?

Peter BurkholderSearch and Replace Formatting: Under markup, I could export a page to a real editor, and change all the .h1 to .h2, or the \{code\} to \{blockquote\}  That's a trivial example, but often had real-use cases when, say, my boss has pasted in an email, verbatim, and I needed to change all the forward indents so it's useful going forward, or when importing a page from some off-the-radar wiki out there   
Peter Burkholder Mouseless editing: As a sufferer of RMI, I keep my injury in check by using a keyboard instead of a mouse as much as possible.  I don't see how to do that anymore, for example, something as simple as starting a \{code\} block and then exiting it.  ESC doesn't work, nor TAB. Peter Burkholder, you should be able to escape the code block with the "up"/"down" arrow keys once you have reached the beginning/end of the code block  
Peter BurkholderToday I had to work on several significant planning pages while on a trip with no network access.  With mark up this can still be done, but in 4.x that is gone   
Anonymoushow do I get lines to be single spaced?shift + enter  
AnonymousI wanted to edit the urls/text of links. in the wiki format i could just take [a|http://b] and modify the content of the link or the title. now i have to get a GUI popup, click link, edit the link url in the popup, and then edit the link text separately. much much worse user experience for a power user.   
Ilya Kaplun

i used to be able to say {code:sql} and paste formatted code into the editor, and get a nice, syntax highlighted code block. now the only way to specify the language as SQL is to double click, open the gui editor, select from dropdown.

Greg WhitfieldCan you do a comprehensive "New Editor for Hardcore Wiki Markup Users" tutorial/whitepaper/video, that explains how they would work around the limitations imposed by the removal of the wiki editorGreg, can you let me know what limitations people are reporting?  
Eddie Fastcursor navigation doesn't behave as expectedEddie, can you give me some specifics on this one?  
Eddie Fast copy/paste doesn't work as expectedAnd this one (smile)  
Eddie Fast pasting into a bulleted list causes the entire document to go bold

Do you have the steps to reproduce this? Was it copying text that was bold? I'd like to try and reproduce and raise a JIRA ticket for this bug.

On your broader question about reporting bugs (like this one), JING is quite good to do a screencast of exactly what you did and the end result.


Diego Ballve

Jean-Yves Avenard

Shortcuts? I'm sure they are there.. but what about some simple list as the wiki markup list? And please don't tell me to click this icon or that icon, that is not what I'm after. Consider a help bar in the right side of the editor, for instance.

I can't remember all the keyboard shortcuts as there are so many of them

Diego, Jean-Yves have you seen the ? icon at the top right of the editor bar? Click this gives you all of the shortcuts. Does this help, or do you mean that there should be a permanently displayed list of these while editing at all times?  
Jean-Yves AvenardYou start entering a macro, and your workflow is interrupted by distracting UI asking you to enter the arguments....   
Jean-Yves AvenardIt's just not possible to concentrate on the content and focus on the aspect laterJean-Yves interested on more detail on this. Since you could just create text and format it later, I assume there is more to it than that?  
Diego BallveNavigation is gone from the side when editor is on.. why?Diego, can you let me know what you mean by this one?  
AnonymousThe new editor is nice, but is a pain. A lot of functionality is lost. A lot of productivity is lost.Love to get the details of the functionality and productivity  
nicolas frankstill som bugs to fix, but I am sure it will progress through the next versionsNicolas, if you have any specific bugs you'd like listed please let me know  
  • Loss of the wiki editor to work around that is catastrophic.
    • Poor handling of copy paste (just try to rearrange a bulleted list)
  • Summary: AAAAAAARG!
CONF-23842 shipped in 4.0.5CONF-23842RESOLVED
Alexander BezrukAbility to nest expand macrosIn 3.5 you could create additional expand user macros with different names (expand2, expand3 etc, technique described here) and they would work while nested. Using this technique, with that old user macro code doesn't work.  
AnonymousCreate a link on one line, looks fine in editor but preview has the link extending to the rest of the text on the page   
AnonymousMonospace text not ending where it should, I then have to mount my mouse and navigate through some little buttons to remove the formatting CONF-23984 
Don GambleChanging a macro from one type to another is now more complicated and no longer obvious. Yes you can select the macro, open the macro dialog, hit back, and then change the macro - but this is neither quick or obvious.Don has raised CONF-24026 also  
Don GambleWith the new editor there appears to be no way to delete a macro and leave the body. This is a real issue when you are editing with sections and columns and you are making major format and organizational changes. Cutting and pasting the body is a slow and clumsy solution.Don has raised CONF-24026 also  
Don GambleCreate separation between Macro containers and their contents and other similar relationships, eg: Links as containers for images See 'recommendation' section below in comment  
Don GambleExperiencing issues with cursor placement / cursor not being present on the screen and also selection highlighting problemsDon to advise his OS and Browser so we can do more testing using his examples below in his comment   
Matthias BaslerWorking with lots of sections/columns (f.e. we use them to position images and their captions) causes very clumsy nested macro blocks having lot of white space. This reduces the amount of visible content in the editor and makes the page appear very large (in the editor), which makes it hard to find the pieces to edit. Having a more compact appearance (similar to the tables!) would be preferable. Having a more compact appearance (similar to the tables!) would be preferable.   
Don GambleIn Firefox, selecting an image does not highlight it.TinyMCE issue that predates new editor, but tracking here since it was mentioned in the commentsCONF-19882 
Alexy KotenkoSo the problem is this - is in the text I've pasted below I copy a line "- rollout (release, 'there') script "/database/main/JIRA_full_ticket_number_rollout.sql" and paste in below replacing the "asdad" line - editor is stuck, no editing available any more, no hotkeys working. Luckily the browser keeps working so I can click "Save" with a mouse and not loose the work done before it.Bug has been filed and marked as critical. Will update you when this has been fixed.CONF-24066 
Alexander BezrukWhen copying (such as text from a Web page Documentation for Confluence) and the subsequent pasting into a new page editor formatting is preserved.
This is often not required. Only need to insert text without formatting.

In OSX you can natively do a 'Paste and Match Style' from the Edit menu or with the keyboard shortcut Command+Option+Shift+V

Can others recommend alternatives for other OS's?

Grant MantleIf there was a spelling mistake, and corrected with Chrome's dictionary selection, the replaced word automatically hops into the next column.Bug. JIRA case raised.CONF-24120 

I made a new page with enumerations... I colored most lines in green - not at once, but time after time. Now i mark the whole text and try to change the color to black. Guess what: some lines change to black. Some lines change to dark blue. (?? maybe these lines where blue some time ago??)  And many lines stay green. If I only mark a paragraph at one time, the color is changed.


  1. copied and pasted a whole page into a new one. (enumerations, numbered Lists, everything green text color)
  2. marked all (strg-a)
  3. changed text color to black

Voilà, in one line the text disappeard! really gone, not white colored! bullet of the enumeration is still there. Can reproduce it as i sit here.

Could not reproduce in entirety but did see two bugs. JIRA case raised.

Anonymous if you come back to read this can you advise what OS and Browser you were using?

Anonymousnone-linked text becomes linked (also wrong) when doing copy and paste
ldap:///CN=<CATruncatedName><CRLNameSuffix>,CN=DC1,CN=CDP,CN=Public Key Services,CN=Services,<ConfigurationContainer>
ldap:///CN=<CATruncatedName><CRLNameSuffix>,CN=DC1,CN=CDP,CN=Public Key Services,CN=Services,<ConfigurationContainer>
JIRA case raised for reviewing autolinkingCONF-24122 

Additional Ideas

While we want the focus of this page to remain specific and detailed feedback on the new editing experience that we can address, a number of people have put considerable effort into outlining their ideas for alternate editing strategies and we also wanted to capture these below:

Alexy Kotenko​Okay, as the WYSIWYG abilities are wider than wiki markup allows - let it be. But you can still provide a solution similar to one implemented in JIRA search. In there you have a search form for rather simple requests, and direct SQL edit for complicated requests. And if directly edited SQL is too complicated to show it as a form - it just tells you "search query is too complicated" and doesn't allow to switch back to form.

As earlier you have claimed that implementing XML-to-wiki transformation is easy - I see no problem to still allow wiki edit, but with XML format on backend and disallow wiki if something too complicated was created through WYSIWYG.

This can easily be added as a plugin, to solve your problem with complains on the core software.


(In reponse to Alexy)

This sounds like a very good idea, and I hope Atlassian will take the time to investigate it. By definition, people who still want to use wiki markup will not be using the most complex WYSIWYG-only formatting, so it should be possible to convert almost everything such users write back to markup.

Another suggestion would be to extend the Wiki Markup Styler plugin to do the same thing.  Ideally, any content that can be converted back to markup, would be. And any complex elements that cannot be converted would just appear as they do in the normal WYSIWYG view. This would avoid the possibility of one complex piece of content causing a whole page to be marked as "too complicated to edit through wiki markup".

If Atlassian choose to do this, the other vital requirement (for me) is that we can copy the wiki markup from the editor. At the moment, the plugin displays markup elements on-screen, but if I try to copy them it just gives me the underlying text. In common with other commenters, sometimes I prefer to copy markup from a Confluence page into a text editor and edit it there, before pasting it back (either into a different page, or into another part of the same page). 
Todd Day

Ability to wrap entire pages in the Wiki Markup macro and not have them auto-convert to storage format. Additionally:

  • Macros that come from plugins I currently use in 3.5 continue to work the same way in the wiki code block.  I'm willing to wait for the authors (Adapatvist, Customware, and the guy who wrote the LaTeX plugin) to upgrade their plugins for 4.0, but the end result must be that I can write in 4.0 wiki code blocks the same way I currently write in the 3.5 wiki editor.
  • User macros I wrote for 3.5 need to also appear in the 4.0 wiki code blocks.
  • When upgrading from 3.5 to 4.0, I want the upgrade process to wrap every page in a wiki markup block instead of converting it to the new XHTML format.
  • Site and Space themes should be definable in terms of Wiki format.
  • It would be nice if the wiki code blocks had a button on them that would convert to the new XHTML format if you pressed it.  I understand this would be a one-time no-reversal operation, and that would be fine with me.



Commonly brought up comments which may be of use to others who are following this page

I have a script that generates Wiki Markup and wrote it to a Confluence page using the API, can I still do this?Yes. You can still send Wiki markup to the API which will convert it to the new source format and save.
  • No labels