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

README not rendered, but why?


Hi, I'm trying to get my file to display in the source page, but I only see:

Not getting that to display...

Normally, you'd see the README here, but something didn't go right.

Try again

Clicking on the "Try again" link shows a turning circle for a few seconds and then the same message again.

My file renders just fine with

How can I get to know what the problem with the file is?

I have created my file locally, then committed and pushed it. I also tried to follow the guide to create the README file from the web interface - I deleted the file, and tried to find the "Create README" button the manual mentions, but I couldn't find it anywhere.

The repository is here, if someone wants to take a look:

2 answers

2 accepted

0 votes
Answer accepted

Hi @Kaziq,

Please allow me to step in as Norbert is out of office.

Since your repository is public, I checked the Developer Tools > Network tab while loading the Source page of your repo. In there, I can see the request to get the file returns a 400 error with the error message:

We cannot detect the file's encoding; unable to render file.

If I clone the repo and check the file's encoding, it shows as 'iso-8859-1':

$ file -I text/plain; charset=iso-8859-1

Would it be possible to change the file's encoding to UTF-8 and then push it to Bitbucket? As per my testing, this should solve the issue.

Kind regards,

Yay, it works now. Thank you.

That's good to hear, you are very welcome.

Please feel free to reach out if you ever need anything else!

Kind regards,

0 votes
Answer accepted
Norbert C Atlassian Team Jun 20, 2022

Hi Kaziq,

Thank you for contacting Atlassian Community. I'm Norbert and I'm a Bitbucket Cloud Support Engineer, it's nice to meet with you!

I would like to inform you that we're not able to display the README file as you're linking the picture to your local repository, which unfortunately doesn't work:

![Board view from the top](/images/brd_top.png)

As a workaround, can I suggest you to upload the pictures under the Downloads section and change the syntax to something like this?

![Board view from the top](

 Please let me know if that helps.

Best Regards,
Atlassian Bitbucket Cloud Support

Thank you for the suggestion, but it still doesn't work.

I also noticed the image file extensions were wrong (png vs. jpg). I changed them, but the problem persists.

I pasted the updated images to the online markdown viewer, and they show up just fine.

What could be the issue now?

Suggest an answer

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

Git push size limits are coming to Bitbucket Cloud starting April 4th, 2022

Beginning on April 4th, we will be implementing push limits. This means that your push cannot be completed if it is over 3.5 GB. If you do attempt to complete a push that is over 3.5 GB, it will fail...

2,166 views 2 9
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