Forums
Home Product Q&A Discussion groups Articles Ask a question Search
Learning
Events
Champions

Forums

Articles
Create
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Search instead for 
Did you mean: 
Product Q&A
See all
Community resources
Top groups
Explore all groups
Community resources
Learn
Community resources
Events
Community resources

Bitbucket Markdown -- Add a Table to a List Item

Paul Mellor
Paul Mellor
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
Get involved
June 4, 2018

I wish to add a table to a numbered list in bitbucket markdown.

Something like this:

1. Define the following role for the user:

    |Role               |Description                 |

    |---                  |---                               |

    |**UserRole**  |The role is blah-blah  |

2. Etc

I tried indenting by 4 spaces and 8 spaces. Neither shows the table as it should, but the 8 spacing at least shows the table as a pre-formatted table. What can be done to present the table as a proper table?

Answer
Watch
Like Be the first to like this
1271 views

1 answer

0 votes
Ana Retamal
Ana Retamal
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
June 5, 2018

Hi Paul! Bitbucket does not support <html> so you need to use the - (dash) and the | (pipe) symbols to construct a table. The first line contains column headers. Separate columns with the pipe symbol.

The second line must be a mandatory separator line between the headers and the content. Subsequent lines are table rows. Columns are always separated by the pipe (|) character. For example:

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

You can only put simple lines in a table.

For more info about what you can do with tables, I recommend you checking  Markdown demo.

Hope that helps!

Ana

View More Comments
Paul Mellor
Paul Mellor
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
Get involved
June 5, 2018

Thanks Ana.

The issue is around adding a table to a numbered list. I create the tabkle as you say, but when I nest in a numbered list it does not show correctly.

Are tables supported in numbered lists in Bitbucket? If not, maybe it's needs to be raised as a bug?

Like
Reply

Suggest an answer

Log in or Sign up to answer
Bitbucket
Bitbucket
TAGS
AUG Leaders

Atlassian Community Events

    See all events
    Community
    Forums
    FAQs Forums guidelines
    Learning
    About learning Resources
    Events
    Champions
    Copyright © 2025 Atlassian
    Privacy Policy Notice at Collection Terms Security