This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Working with Lists

Added by Vidya Madabushi, last edited by Sarah Maddox on Oct 24, 2007  (view change)
All Versions
Click for all versions
Confluence 2.9 Documentation

Index

Confluence allows you to create bulleted or numbered lists, and is flexible enough to allow a combination of the two lists.

If you need to separate the text within lists using line breaks, make sure you do so using a double slash (//). Empty lines may disrupt the list.

Simple lists

Use the hyphen (-) to create simple lists.
Make sure there is a space between the hyphen and your text.

What you need to type What you will get 
- some
- bullet
- points
  • some
  • bullet
  • points

Bulleted lists

Use the asterisk (*) to create bullets. For each subsequent level, add an extra asterisk.
Make sure there is a space between the asterisk and your text.

What you need to type What you will get 
* some
* bullet
** indented
** bullets
* points
  • some
  • bullet
    • indented
    • bullets
  • points

Numbered lists

Use the hash (#) to create numbered lists.
Make sure there is a space between the hash and your text.

What you need to type What you will get 
# a
# numbered
# list
  1. a
  2. numbered
  3. list

A second level of hashes will produce a sub-list, such as the alphabetical sub-list shown below.

What you need to type What you will get 
# Here's a sentence.
## This is a sub-list point.
## And a second sub-list point.
# Here's another sentence.
  1. Here's a sentence.
    1. This is a sub-list point.
    2. And a second sub-list point.
  2. Here's another sentence.

Try a third level of hashes to produce a sub-sub-list.

What you need to type What you will get 
# Here's a sentence.
## This is a sub-list point.
### Third list level.
### Another point at the third level.
## And a second sub-list point.
# Here's another sentence.
  1. Here's a sentence.
    1. This is a sub-list point.
      1. Third list level.
      2. Another point at the third level.
    2. And a second sub-list point.
  2. Here's another sentence.

In numbered lists as described above, the format of the 'number' displayed at each list level may be different, depending upon your browser and the style sheets installed on your Confluence instance. So in some cases, you may see letters (A, B, C, etc; or a, b, c, etc) or Roman numerals (i, ii, iii, etc) at different list levels.

Mixed lists

What you need to type What you will get 
# Here
#* is
#* an
# example
#* of
#* a
# mixed
# list
  1. Here
    • is
    • an
  2. example
    • of
    • a
  3. mixed
  4. list
RELATED TOPICS

Working with Text Breaks
Confluence Notation Guide Overview

Take me back to Confluence User Guide
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (16)

 

  1. Jun 26

    Anonymous says:

    I was wondering... is there anyway to change the way the number tables play out?...

    I was wondering... is there anyway to change the way the number tables play out? For example, instead of..

    1. example
      1.  example
        1. example
    2. done

    it could go.. 1, then 1.1, then 1.1.1, then 2.?

    Thanks  

    1. Jun 27

      Tony Cheah Tong Nyee says:

      Hi there, I believe this is not possible at the moment. However, we are aware o...

      Hi there,

      I believe this is not possible at the moment. However, we are aware of such needs and have an open request regarding it being tracked at:

      Feel free to cast your vote to increase its popularity and add yourself as a watcher for future updates.

      Cheers,
      Tony

  2. Jul 02

    Anonymous says:

    Does anybody else have a problem regarding lists and indents/outdents? Every ti...

    Does anybody else have a problem regarding lists and indents/outdents?

    Every time I make a list, I conclude it with text. What the list does, however, is influence the concluding body of text by carrying over the indention property that it has. The results of this is that the concluding body of text cannot be made flush with the left side, which is what I want to do.

    I've tried both Rich Text, Wiki Markup, and a combination of the two with no avail. Can anybody help me out here?

    Thanks I appreciate it. 

    1. Jul 03

      Ming Giet Chong says:

      Hi, Could you please raise a support ticket at our issue tracker at: https:/...

      Hi,

      Could you please raise a support ticket at our issue tracker at:

      Please also attach the relevant information to the support ticket for further investigation. Thanks.

      Regards,
      MG

  3. Jul 04

    Anonymous says:

    Hi, Is there some way to enforce continued numbering of a numbered list rather ...

    Hi,

    Is there some way to enforce continued numbering of a numbered list rather than start it with 1? I am working with a complex procedure and there is lots of text and tables between numbered steps, and at some point Confluence gets confused and restarts numbering of the procedure in the middle.
    Maybe there is some way how I can specify the number with which a numbered list should start?

    Thanks!

    Juris.

    1. Aug 13

      Cameron Christensen says:

      I am also interested in this functionality.  I seem to frequently end up wi...

      I am also interested in this functionality.  I seem to frequently end up with output that looks like:

      1. blah blah

      stuff

      1. blah blah blah

      more stuff

      1. *sigh*

  4. Jul 18

    Anonymous says:

    I was trying to find a way to make formatted dictionary entries, like "<dl>...

    I was trying to find a way to make formatted dictionary entries, like "<dl></dl>" in HTML and ";<term>: <def>" in regular wiki markup. Is there something closer than the two list type shown above?

    1. Jul 24

      Ming Giet Chong says:

      Hi, You can try using the Html plugin and the Content Formatting macro to inclu...

      Hi,

      You can try using the Html plugin and the Content Formatting macro to include the html code in Confluence page. You should be able to define your own format for that.

      Hope this helps.

      Regards,
      MG

  5. Aug 17

    Anonymous says:

    Hi, We have complex procedures that uses many lists.  We like to add lines...

    Hi,

    We have complex procedures that uses many lists.  We like to add lines between the items in the lists, without breaking the list, eg

    1. Item one

    (if I click enter to leave a space, the numbering starts again at 1.)

    1. Item two

    I've worked out that if I place a &nbsp character (in the markup tool) where I want a space, then it will add a line without stuffing up the numbering.  But is there and easier way of inserting line breaks from the Rich Text Editor, instead of the markup tool? 

    I don't understand the instructions in the beginning of this page: ("If you need to separate the text within lists using line breaks, make sure you do so using a double slash (//). Empty lines may disrupt the list").  Do you mean double front slash or double back slash.  This does not seem to work?

    1. Aug 17

      David Peterson [CustomWare] says:

      It should be a double backslash. Not sure why the forward slash was listed, but ...

      It should be a double backslash. Not sure why the forward slash was listed, but I do know it's impossible to output a double backslash in regular wiki markup...

      Try:

      # Item 1
\\
Another line in Item 1
\\
# Item 2
\\
Another line in Item 2

      1. Aug 17

        Anonymous says:

        Thanks for the quick reply.  I tried the above, but the character doesn't ...

        Thanks for the quick reply.  I tried the above, but the
        character doesn't seem to leave line breaks between the items.  What does work is the following character (&nbsp), but I'm not sure if it's the correct character to use?:

        # Item 1

        &nbsp
        Another line in Item 1
        &nbsp

        # Item 2
        &nbsp

        Another line in Item 2

        1. Aug 17

          David Peterson [CustomWare] says:

          Yeah, I guess that would work - you just need something on each line for the par...

          Yeah, I guess that would work - you just need something on each line for the parser to consider it part of the previous list item, so a non-breaking space should work.

  6. Sep 30

    Anonymous says:

    how do we add bulleted formats with in a table.

    how do we add bulleted formats with in a table.

    1. Oct 06

      Azwandi Mohd Aris says:

      Hi there, The wiki markup is pretty much straightforward, where you have the bu...

      Hi there,

      The wiki markup is pretty much straightforward, where you have the bulleted list within the table markup:

      | * Point 1 | - Point 2
- Point 3|

      which will produce:

      • Point 1
      • Point 2
      • Point 3

      Hope that helps.

      Cheers,
      Azwandi

  7. Oct 01

    Anonymous says:

    I would like to change the look of the bullets I use in a bulleted list...for ex...

    I would like to change the look of the bullets I use in a bulleted list...for example a right pointing arrowhead in a color.  How can this be accomplished?

    1. Oct 14

      Ming Giet Chong says:

      Hi, You can try modifying the CSS file of Confluence page. You can perform this...

      Hi,

      You can try modifying the CSS file of Confluence page. You can perform this by following the steps below:

      1. Go to Administration-> Custom HTML
      2. In the "At end of the HEAD tag" field, type in the following sample code: 
        <style type="text/css">
  .wiki-content ul, ol { margin:0px 0; }
  .wiki-content ul { list-style-type:square; }
</style>

      The sample code above will change the default marker to square. For more information on CSS List-style-type property, please look at the link below:

      Hope this helps.

      Regards,
      MG

Add Comment