nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

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/

Accepted answers

Norbert Csupka

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

Theodora Boudale

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

All comments

Norbert Csupka

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?

Theodora Boudale

Hi @Kaziq,

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

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

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

cloud

bitbucket

bitbucket-cloud

readme