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

Markdown formatting broken in project overview Edited

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

22 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

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.

Disabling "New source browser experience" does not help


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

Like # people like this

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

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... :(

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

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

plz fix this.

Welp, still broken almost a year now.

Considering moving the whole project out of Atlassian XD

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

Probably there is something wrong with state or cache.

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.

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.

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

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

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

Ran into this issue too

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". 


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? 

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.

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!

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

Suggest an answer

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

How do you use the Bitbucket-Jira integration? How does it help your team?

Hey everyone, over the past year, we've added several new features on how you can use Bitbucket and Jira together. We'd love to know how you'll are using the integration and how it's helping your t...

121 views 0 2
Join discussion

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