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

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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 Edited

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.

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!

Ana

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,

Ana

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.

Documentation says that a limited HTML tags are supported in README.md 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
rtasooji I'm New Here Dec 10, 2020

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

Suggest an answer

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

Powering DevOps with Bitbucket Server & Data Center

Hi everyone, The Cloud team recently announced 12 new DevOps features that help developers ship better code, faster   ! While we’re all excited about the new improvements to Bitbucket ...

2,358 views 1 8
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