Confluence 4.0 has reached end of life
Check out the [latest version] of the documentation
This page is a DRAFT and is visible to Atlassian staff only. We will publish it sometime before the release of Confluence 4.0, when we have enough verified content to be useful.
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 shortcuts instead of the toolbar.
- The autocomplete shortcuts are derived from wiki markup!
On this page:
Hints to Get You Started Quickly
- Type wiki markup into the editor. The autocomplete function will convert the wiki markup as you type.
- Learn the keyboard shortcuts. Click the help icon on the editor toolbar to see a list of shortcut keys. We do not mention them below. This page is all about wiki markup. You can read the page about keyboard shortcuts.
Autocomplete in Action
Here are a few short videos showing some of the autocomplete magic.
Making text bold, italic, underlined. |
Insert 30-second video here. |
Adding a heading. |
Insert 30-second video here. |
Adding a tick. |
Insert 30-second video here. |
Using bulleted and numbered lists. |
Insert 1-minute video here. |
Adding an image |
Insert 1-minute video here. |
Before and After Guide for Wiki Markup Fans
Below are the most commonly used autocomplete shortcuts. Go play with Confluence to find the rest!
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: |
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* |
Unable to render {include} The included page could not be found. |
Heading levels |
Typed the heading level in wiki markup. Example: h2. Midnight at the Lost and Found |
Unable to render {include} The included page could not be found. |
Underlining, italics, superscript, subscript |
Typed the wiki markup characters before and after your text. |
Type the wiki markup just as you did before. Autocomplete will convert it as you type. |
Left, centre and right alignment |
Not available in previous versions of Confluence. |
Unable to render {include} The included page could not be found. |
Indentation |
Not available in previous versions of Confluence. |
Click the left and right indentation buttons on the editor toolbar: |
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: |
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 Macros |
What you did before |
What to do now |
Adding a macro to your page. |
Typed curly brackets, the macro name and parameters. Example: Read 'em and weep: {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: |
Adding symbols and emoticons |
What you did before |
What to do now |
Smiley |
Typed a colon and parenthesis. 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 parentheses. Example: (/) |
Type the wiki markup. 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: |
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: |
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: |
Linking to a |
Typed the text, the 'mailto' parameter and the email address inside square brackets. Example: [Sales|mailto:jsmith@non.existent.corp.com] |
TBC. |
Linking to an anchor on a page |
Typed '#' and the anchor name inside square brackets. Examples: [#anchorname] [Page Name#anchorname] |
TBC. |
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: |
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 |
Unable to render {include} The included page could not be found. |
Adding numbered items |
Typed a hash '#' in wiki markup. Example: My list: # A Time for Heroes |
Unable to render {include} The included page could not be found. |
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 | | |
Unable to render {include} The included page could not be found. |
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: |
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. _ |
Linking an image |
Included the image markup inside the link markup. Example: [!Home By Now^NoMatterWhat.png!|http://www.example.com/song] |
TBC. |
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|height=800,width=600,id=media! |
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
There are a few things you can no longer do in the Confluence 4.0 editor, that were possible using wiki markup in Confluence 3.5 and earlier.
Note: Development of Confluence 4.0 is ongoing! It is possible that some of the items below will be available in the final version of Confluence 4.0. We will update this list whenever things change.
Things you cannot do in Confluence 4.0:
- Copy the source of a page from a Confluence 4.0 site. There is no way to copy the XHTML source code. Also, if you do not have edit permission on a page, you cannot view or copy the rich text source of the page.
- Remove sections and columns but leave the content in place. Removing the section/column formatting also removes the content. You need to copy or cut the content, paste it to the new location, then remove the sections and columns.
- Specify an image size in pixels or percentages. The image properties panel offers the following options for image size: small, medium, large and original size.
- Edit a page in Microsoft Word. See FAQ entry.
RELATED TOPICS
Using Autocomplete in the Rich Text Editor
Keyboard Shortcuts
Planning for the New Editor in Confluence 4.0