Confluence 4 Editor - What's Changed for Wiki Markup Users

This quick-reference guide is for people who regularly used the wiki markup editor in earlier versions of Confluence. It shows you how to use the new editor to do the things you have always done. And more.

The editor offers a number of options in the toolbar. But did you know...?

  • You can use autocomplete and autoformatting shortcuts instead of the toolbar.
  • The trigger characters for autocomplete and autoformatting are derived from wiki markup.
  • You can add macros, links and images by typing the entire wiki markup element. As soon as you close the macro, link, or image, Confluence will convert it to rich text format and add it to the page.

Hints to get you started quickly

  1. Type wiki markup into the editor. Confluence's autocomplete and autoformat will convert the wiki markup as you type.
  2. Learn the keyboard shortcuts. Click the help icon on the editor toolbar to see a list of keyboard shortcuts.
  3. Undo the autocomplete and autoformat actions. To undo something that autocomplete or autoformat has done, press Ctrl+Z (Windows) or Cmd+Z (Mac).

Before and after guide for wiki markup fans

Below are the most commonly used autocomplete and autoformatting triggers.

Using wiki markup

What you did before

What to do now

Typing wiki markup:
Typed text and wiki markup into the Wiki Markup Editor pane.

Start typing wiki markup – try it and see what happens!

Pasting wiki markup:
Pasted wiki markup into the Wiki Markup Editor pane.

Click ' Insert' > ' Wiki Markup' on the editor toolbar. Note: Confluence will convert the wiki markup to rich text as soon as you add it to your page. The wiki markup will not be available for editing after that. Example:

Adding macros

What you did before

What to do now

Adding a macro to your page:
Typed curly brackets, the macro name and parameters. Example:

{blog-posts}
Type ' {' and start typing the macro name to see a list of macros that match your text. Press the arrow keys to select the macro you want. Example:

Alternatively, use wiki markup entirely. Type the macro, including its parameters and the closing curly bracket. As soon as you close the macro, Confluence will convert it to rich text format and add it to the page. This means that you can skip the macro browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: {blogposts:content=titles|author=jsmith}

Formatting text

What you did before

What to do now

Bold text:
Typed an asterisk '*', your text, then another asterisk in wiki markup. Example:

*Surf's Up*
Type an asterisk '*', your text, then another asterisk. Confluence autoformat will convert the text to bold immediately. Example:

*Surf's Up*

Heading levels:
Typed the heading level in wiki markup. Example:

h2. Midnight at the Lost and Found
Type the heading level and a full stop. Autoformat will convert the line to the appropriate heading immediately. You can continue typing your heading text immediately. Example:


h2.

Underlining, italics, superscript, subscript:
Typed the wiki markup characters before and after your text.

Type the wiki markup just as you did before. Autoformatting will convert it as you type.

Left, centre and right alignment:
Not available in previous versions of Confluence.

Click the left, centre and right alignment buttons on the editor toolbar:

(info) This can also be used to align images independently of text.

Indentation:
Not available in previous versions of Confluence.

Click the left and right indentation buttons on the editor toolbar:

Line break:
Started a new line with no empty line.

Press Shift + Enter to force a line break without a paragraph break. This is a line break with no extra space.

Quotation:
Typed the {quote} macro in wiki markup. Example:

{quote}Life is a lemon.{quote}

Use the Quote style – select ' Quote' from the style dropdown menu or use the keyboard shortcut. Example:
Or type bq. in the editor

Colour:
Typed the {color} macro in wiki markup. Example:

{color:green}Bat out of Hell.{color}
Click the colour options on the editor toolbar. Example:

Adding symbols and emoticons

What you did before

What to do now

Smiley:
Typed a colon and a round bracket. Example:

:)
Type the globally-recognised markup for a smiley face (colon and round bracket), a wink (semicolon and round bracket), and so on. Autocomplete will convert it as you type. Example:

:)

Tick or check mark:
Typed a forward slash in round brackets. Example:

(/)
Type a forward slash in round brackets. Autocomplete will convert it as you type. Example:

(/)

Linking text

What you did before

What to do now

Linking to a Confluence page:
Typed the text and pasted the page name inside square brackets. Example:

[Modern Girl|Modern Girl song lyrics]
Type a square bracket ' [' and start typing the page name to see the suggested pages to link to. Press the arrow keys to select the page you want. Example:

Alternatively, use wiki markup entirely. Type the link, including the alias and the page name or URL. As soon as you type the closing square bracket, Confluence will convert the link to rich text format and add it to the page. This means that you can skip the link browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: [Modern Girl|Modern Girl song lyrics]

Linking text to a web page:
Typed the text and pasted the link inside square brackets. Example:

[Modern Girl|http://www.example.com/song]
Type a square bracket ' [' and select ' Insert Web Link', then paste the URL into the link dialog. Example:

Alternatively, use wiki markup entirely. Type the link, including the alias and the URL. As soon as you type the closing square bracket, Confluence will convert the link to rich text format and add it to the page. This means that you can skip the link browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: [Modern Girl|http://www.example.com/song]

Linking to a page that does not yet exist:
Typed the name of the non-existent page inside square brackets. Example:

[Future of the Modern Girl]
Type a square bracket ' [' and the name of the non-existent page, then select ' Insert Link to Create Page'. Example:

Alternatively, use wiki markup entirely. Type the link, including the alias and the page name or URL. As soon as you type the closing square bracket, Confluence will convert the link to rich text format and add it to the page. This means that you can skip the link browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: [Future of the Modern Girl]

Linking to an attachment:
Typed '^' and the attachment name inside square brackets. Examples:

[^attachment name]
[Page Name#^attachment name]
Type a square bracket ' [' and start typing the attachment name to see the suggested attachments to link to. Press the arrow keys to select the item you want. Example:

Alternatively, use wiki markup entirely. Type the link, including the alias (if required), the caret character ^ and the attachment name. As soon as you type the closing square bracket, Confluence will convert the link to rich text format and add it to the page. This means that you can skip the link browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: [^attachment name]

Linking to an anchor within a page:
Typed the page name with the anchor name appended. Example:

{anchor:index}
[Page Two#index]

To create the anchor: Add an anchor macro using wiki markup. Confluence will convert the macro to rich text format and add it to the page. For example, to create an anchor named 'index', type the following: {anchor:index}

To create the link: Use wiki markup too. Type the link, including the alias (if required), the hash character # and the anchor name. As soon as you type the closing square bracket, Confluence will convert the link to rich text format and add it to the page. This means that you can skip the link browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing bracket manually.
  • Example: [Index|#index]

Using bulleted and numbered lists

What you did before

What to do now

Adding bullets:
Typed an asterisk '*' in wiki markup. Example:

My list:
* Bad Attitude
Type an asterisk '*' followed by a space. Autoformat will convert the line to a bulleted list. You can continue typing your text immediately. Example:

(info) To add another line of text to an entry without creating a new list item, press Shift + Enter at the end of the line.

Adding numbered items:
Typed a hash '#' in wiki markup. Example:

My list:
# A Time for Heroes
Type a hash or pound '#' followed by a space. Autoformat will convert the line to a numbered list. You can continue typing your text immediately. Example:

(info) To add another line of text to an entry without creating a new list item, press Shift + Enter at the end of the line.

Adding line breaks in a numbered/bulleted list:
Started a new line. Typed a double slash for an empty line. Example:

//

Press Shift + Enter.

Using tables

What you did before

What to do now

Adding a table:
Typed pipe characters '|' in wiki markup. Example:

||  || Title || Owned ||
| 1  | 	45 seconds of ecstasy | Y |
| 2  | 	Amnesty Is Granted |   |
Type a series of pipe characters '|' then press Enter. Autoformat will convert the pipes to a table. Example – to create a table with three columns:

| | | |

Editing a table:
Edited the text and shuffled the pipe characters around.

Learn the keyboard shortcuts for table editing. Click the help icon on the editor toolbar to see a list of shortcut keys.

Displaying images

What you did before

What to do now

Displayed an image attached to the page:
Typed/pasted the image name inside exclamation marks '!'. Example:

!NoMatterWhat.png!
Type an exclamation mark ' !' and start typing the image name to see the suggested images to insert onto the page. Press the arrow keys to select the item you want. Example:

Alternatively, use wiki markup entirely. Type the wiki markup for the image insertion, including the exclamation marks, the space and/or page name (if different from the current page) and the image name, as well as any other allowed parameters. As soon as you type the closing exclamation mark, Confluence will convert the image to rich text format and add it to the page. This means that you can skip the image browser.

  • This works if you have 'Autoformatting' enabled in the editor settings in your user profile.
  • This does not work if you paste the wiki markup onto the page. You need to enter the closing exclamation mark manually.
  • Example: !NoMatterWhat.png|align=right!

Displaying an image attached to another page:
Typed/pasted the page name, a '^' and the image name inside exclamation marks. Example – to display an image that is attached to the page titled 'Home By Now':

!Home By Now^NoMatterWhat.png!

Exactly the same as when the image is attached to the same page, or use the new "Search" tab in "Insert" > "Image"

Aligning images:

!NoMatterWhat.png|align=right!

Click on the image and then:

Click the left, centre and right alignment buttons on the editor toolbar:

(info) This can also be used to align images independently of text.

Embedding multimedia files

What you did before

What to do now

Embedding a video, movie or audio file into a page:
Used the wiki markup image format. Example:

!HotPatootie.mov!

Use the Multimedia macro.

Type an exclamation mark ' !' and select 'Insert Other Media'. Example:

Or type ' {' and start typing the macro name 'Multimedia'. Example:

Functionality that is no longer available

This section contains a list of things you could do in in earlier versions of Confluence, but can no longer do in Confluence 4.

  1. Edit a page in Microsoft Word. See FAQ entry.
  2. Edit, copy or view the wiki markup source of a page. This is because content is no longer stored in wiki markup format.

New source editor plugin

The Confluence Source Editor plugin allows users to edit the XHTML-based storage format of the page. You need Confluence 4.1.5 or later to use the plugin.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport