html table in readme does not render as table

Stephan Hradek

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 readme.md, it is simply shown as text, meaning: I can see all html tags.

Below the (shortened) source

 

some headline
-------------

<table>
<thead>
<tr><th>
 Shortcode / Attribute
 </th><th>
 Funktion
</th></tr>
</thead>
<tbody>
<tr><td>
 [something] … [/something]
 </td><td>
 Umklammert den Bereich in dem die folgenden Shortcodes gelten.
</td></tr>
<tr><td>
 [domain]
 </td><td>
 Wird ersetzt durch die Domain des Kundenseite.
</td></tr>
</tbody>
</table>

some more text

 Can anyone explain what's going wrong here?

Update: https://confluence.atlassian.com/bitbucketserver/markdown-syntax-guide-776639995.html 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.

Ana Retamal

 

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!

Ana