Markdown syntax guide unclear about tables

[Deleted user]

Hello,

concerning your "Markdown syntax guide"

https://confluence.atlassian.com/bitbucketserver/markdown-syntax-guide-776639995.html#Markdownsyntaxguide-Tables

Bitbucket uses Markdown formatted text in CommonMark. But the official specification of CommonMark (e.g. https://commonmark.org/help/) has not yet defined how to format tables. There is still an ongoing discussion about tables (see https://talk.commonmark.org/t/tables-in-pure-markdown/81).

So my question is: What kind of format does Bitbucket use to read and display tables properly, so that I can choose the right editor to display / preview tables in my IDE before I push my README.MD file into git?

Thank you.

[Jeff Thomas · Accepted solution]

We have a Java library that we use for CommonMark (https://github.com/atlassian/commonmark-java) with an extension to handle tables (commonmark-ext-gfm-tables). That extension uses GitHub Flavored Markdown for tables. So any tool that is able to preview the GitHub Flavored Markdown for tables should do what you're after.

[Deleted user]

Thank you for this helpful note. Now I know what I have to look for:

CommonMark + tables (GitHub Flavored Markdown or Python-Markdown-Extension*)

*) found this here https://confluence.atlassian.com/bitbucket/readme-content-221449772.html

To make the IDE story short:

Using Eclipse (2019-09 R (4.13.0)) with "GitHub Flavored Markdown viewer plugin for Eclipse" 2.0.1 works (but only if you know the correct install URL https://raw.githubusercontent.com/satyagraha/gfm_viewer/master/p2-composite/).

;-)