Bitbucket Markdown -- Add a Table to a List Item

Question

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?

Paul Mellor · Answer

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?

Ana Retamal · Answer

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