Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

html table in readme does not render as table


Since I require a line break in one of my table cells, I converted my CommonMark / Markdown table into pure HTML.

But it is not rendered as a table in my, it is simply shown as text, meaning: I can see all html tags.

Below the (shortened) source


some headline

Shortcode / Attribute
[something] … [/something]
Umklammert den Bereich in dem die folgenden Shortcodes gelten.
Wird ersetzt durch die Domain des Kundenseite.

some more text

 Can anyone explain what's going wrong here?

Update: suggested that I should,

>For a full list of all the Markdown syntax, consult the CommonMark help or specification.

Which gave me the impression that I can use html tables.

1 answer

0 votes
Ana Retamal Atlassian Team Apr 09, 2018


Hi Stephan! 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!


Like joel likes this
Ana Retamal Atlassian Team Apr 13, 2018

I'm not sure what you mean, in that documentation says that for tables you should use 

| Day     | Meal    | Price |
| --------|---------|-------|
| Monday  | pasta   | $6    |
| Tuesday | chicken | $8    |

Which is similar to what I showed you before.

Were you referring to something else?

Kind regards,


And further to the top it says:


Markdown syntax

The page below contains examples of Markdown syntax. For a full list of all the Markdown syntax, consult the CommonMark help or specification.


Since it explicitly says "examples", I followed the links. The text suggests that the definitiv syntax is described there.

Like joel likes this

Documentation says that a limited HTML tags are supported in and that set contains all table related tags.

I need raw HTML for rowspan and cellspan (not possible with markdown) but it seems that's not supported by bitbucket so yes, that document is misleading and should be updated.

Like # people like this

One year old post and no change at all!

HTML limitations in markdown is a big thing! This is not a feature to be implemented it is a must have thing for documenting. People are keep asking this for years now and nothing so far! If the source code is available, please direct us to the source code and we can work on adding some of html features.

Thank you

Like # people like this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,777 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you