README not rendered, but why?

[Kaziq]

Hi, I'm trying to get my README.md 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 README.md file renders just fine with https://markdownlivepreview.com/

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: https://bitbucket.org/Kaziq/brymen-and-sanwa-ir-interface/src/master/

[Theodora Boudale · Accepted solution]

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 README.md 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 README.md
README.md: 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,
Theodora

[Kaziq]

Yay, it works now. Thank you.

[Theodora Boudale]

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

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

Kind regards,
Theodora

[Norbert Csupka · Accepted solution]

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](https://bitbucket.org/Kaziq/brymen-and-sanwa-ir-interface/downloads/brd_top.png)

 Please let me know if that helps.

Best Regards,
Norbert
Atlassian Bitbucket Cloud Support

[Kaziq]

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?