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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Markdown formatting broken in project overview


bitbucket cloud: our markdown in is broken / does not render as markdown when we first land on the repository overview page in the web UI.


Within the project, if we click somewhere else, like settings, and then back to source, the README markdown then renders as expected. 


does anyone know how to fix this behaviour? 


Screen Shot 2018-06-20 at 2.59.29 PM.jpgScreen Shot 2018-06-20 at 2.59.19 PM.jpg

25 answers

It took a lot of time and so nothing is done... This task is NOT SOLVED!

People, please start voting up these posts. Maybe that will get their attention.

The solution I found is to separate the list items with a blank line. For example:

- item 1


- item 2


- item 3


This also works for enumerated lists.

I know it is not the right way, but until they fix the problem, it is the only solution I have found.

Hi there,

i had the same issue, i solved this disabling the "New source browser experience" feature in Labs into my profile.

Hope this helps!


Thank you so much Gabriele! Indeed, I tried to disable the "New source browser experience" and the README is displayed as expected again.

Thanks a lot for your help :)

Like Ali Albousaifi likes this

Thanks a lot

This helped me massive - I never noticed that the rendering broke with this lab and did not drew the connection.

Deactivated - runs as expected again



Thanks a lot for your help ;-)

the feature itself is removed from the lab options , so this not working anymore:(

Like # people like this

Disabling "New source browser experience" does not help


The existing fix was patched, now it is broken everywhere.

Like # people like this

I noticed that problem for months ago but was not bothered until I have to show new team member our markdown documentation. As of February 2019, still not fixed.

I just hit the same problem in July 2020.  Something so simple should definitely work right out of the box.

the problem still exists and the suggested setting does not help anymore...

Really boring and weird.

I've traced it to happening when you try to make numbered list, but use multiline with offset:

1. one

  one b

  one c

2. two

two b

two c

 Result is

1. one

one b

one c

1. two

two b

two c

Like anna.sikorka likes this

Exact same problem for me, it's been quite a while. It did not bother me so much at first, but for an open source project, the README is pretty essential and having it displayed as a blob of text just makes it useless. It'd be great to know what's happening.Capture d’écran 2018-07-02 à 23.08.40.png

Could you find any more information about this @Alexis Dray?

unfortunately no movement on this issue for me 

It's a shame... I hope more users will comment on this issue so that it stays on top and visible and would be dealt with by Bitbucket, it's really annoying. No use writing a README file if it's not displayed correctly 😕

Like Tom Cervenka likes this

Yes, same problem for me. I deactivated the "New source browser experience feature" for now. Pretty useless if the readme only works 10% of the time.

Hope Bitbucket team will fix that soon.

Also deactivated the “New source browser experience” feature and it works. I hope the Bitbucket team will fix this issue soon.

Not responding on such a simple feature makes me question how long Bitbucket is for this world. Seeing as how they don't seem to be fixing this bug, can someone give a more detailed description of how to turn off the feature? I can't find it in any of the project-specific or account-specific settings, but maybe I missed it.

Hi Rob,

You can turn it off by : clicking on your profile avatar (right/bottom screen), and select "Bitbucket Labs". (or URL should be something like that :

Then turn off the "New source browser experience" functionnality.

Like Rob Hasker likes this

Thanks, though for me the profile avatar is at the bottom left of the screen (in case someone else is not sure what's meant).

This fix is not working anymore.

Like # people like this

Yep, unfortunately not... :(

Welp, still broken almost a year now.

Considering moving the whole project out of Atlassian XD

its broken in some projects and some not, its broken on Chrome, but works on Opera browser, its really confusing!

plz fix this.

I can't believe that more than 3 years later this is still not fixed.

My markdown rendered fine just minutes ago, now it is not. I can render it fine in my computer and on GitHub.

So, I guess we only have one way out, moving all our repositories out to another provider.

Same to me.

Tried to use some workarounds, but no luck. 

I experience incorrect code blocks display inside list items. For some reason Bitbucket displays them as inline code. "Root level" code blocks works well.


After so long... still not working.

Bitbucket Cloud, no 'new source browser experience' on Labs config, and Markdonw in or other's is not displayed correctly :(

Any ETA  Atlassian on taking a look at this? 

Hi there,

now seems that this issue disappears...

I didn't change anything inside my README files or account settings...



Works correctly for me now

I am still having this issue and cannot see an option to disable "new source browser experience". 

Ran into this issue too

Until Atlassian takes a look into this I put a note to all READMEs about the issue pointing to this thread. Some customer teams already asked to move their repos to some alternative solution as they are not able to read a simple README...

Maybe Atlassian will introduce QA if they see us fading away.

Good idea. I can't believe they haven't fixed this by now.

Like Shumnan Suengjitsiriroj likes this

Is there a bug reported on this and what is the number? I can't find it

For me at least, the option to disable the "broken new source browser experience" seems to have been removed.

What a joke. How does shit like this pass QA?

Like Joris Vleminckx likes this

This is so frustrating. Atlassian, please fix this bug. It's impossible to share readme files with colleagues, people have to view them in a markdown editor.

I'm reasonably sure the problem we were seeing was not a cache issue. It's possible there's been a fix, but we were seeing the incorrect behavior on multiple platforms.

I had the same issue, solved when I pressed CTRL + SHIFT + F5 (Full page refresh)

Probably there is something wrong with state or cache.

0 votes

I experienced this issue as well. After trying different things, I figured out that if I add extra blank lines above and below the tables and between the listed items, it renders properly.

I solved it by editing the Readme file through Bitbucket

Yes, great!

But it’s a temporary solution and you have to commit your changes and pull them afterwards to your computer. Whenever you change the file locally and push it to Bitbucket, you have the same problem back.

This worked for me as well. Thanks!

Hi, please indicate-me where is 'New source browser experience' config on the labs?

Please see the Alexis De Moor answer, a few lines above.


Like Yanice Agoune likes this

I've just experienced the issue as well.  The workaround to disable "new source browser" experience worked for me.  Still broken 9 months after the original report.

You mean it "didn't" work for you, right? I can't even find that setting!

Like mcompte likes this

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events