Confluence pages are written in a simple markup language based on Textile. By using this simple markup instead of something like HTML which, while more powerful, is less readable and more complex, Confluence tries to make sure that there are as few barriers as possible to creating and editing pages.

The best way to learn the markup is just to edit a page, and start typing.

The quick notation guide is conveniently placed beside every edit screen. Confluence also permits some complex styling and formatting. Click on the full notation guide in your help window to view the markup for these options. If you are still unsure, this User Guide covers the following sections in detail with examples:

Working with Headings
Working with Text Effects
Working with Text Breaks
Working with Links
Working with Anchors
Working with Images
Working with Lists
Working with Tables
Working with macros

Here's a short example of some typical markup:

h4. Confluence Markup

Ideally, the markup should be _readable_ and even *clearly understandable* when you are 
editing it. Inserting formatting should require few keystrokes, and little thought.

After all, we want people to be concentrating on the words, not on where the angle-brackets 
should go.

* Kinds of Markup
** Text Effects
** Headings
** Text Breaks
** Links
** Other


||  Name  || Office ||
|  Alice  |   01    |
|   Bob   |   23    |
|  Cathy  |   45    |

This produces the following layout:

Confluence Markup

Ideally, the markup should be readable and even clearly understandable when you are editing it. Inserting formatting should require few keystrokes, and little thought.

After all, we want people to be concentrating on the words, not on where the angle-brackets should go.

• Kinds of Markup
  • Text Effects
  • Headings
  • Text Breaks
  • Links
  • Other

For more information, read the Confluence Markup page in the documentation.

Here, in comparison, is how that would look if you had to edit the page in HTML:

<h3>Confluence Markup</h3>
<p>Ideally, the markup should be <em>readable</em> and even <strong>clearly understandable</strong> 
when you are editing it. Inserting formatting should require few keystrokes, and little thought</p>
<p>After all, we want people to be concentrating on the words, not on where the angle-brackets should 
go.</p>
<ul>
   <li>Kinds of Markup
     <ul>
      <li>Text Effects</li>
      <li>Headings</li>
      <li>Text Breaks</li>
      <li>Links</li>
      <li>Other</li>
     </ul>
   </li>
</ul>


<table>
    <tr><th> Name </th><th> Office </th></tr>
    <tr><td> Alice </td><td>  01</td></tr>
    <tr><td> Bob </td><td>    23</td></tr>
    <tr><td> Cathy </td><td>  45</td></tr>
</table>

RELATED TOPICS

Creating a new page

Take me back to Help Home