Markdown syntax error

golszewski-toolla

Hi,

I have a problem with Markdown syntax in README.md, in particular with code blocks. Many tools including Markdown editor embedded in Eclipse IDE and some online editors (like https://stackedit.io or https://www.markdowntutorial.com/) work perfectly fine with my Markdow syntax. However, Bitbucket cloud for some reasons reports errors in my syntax despite I can't find any issues with it.

Here is the content of my README.md file: https://pastebin.com/dp99JeaH

And here is how it renders. As you can see, some (but not all) code blocks have text highlighted in red and the generated html contains span with class err suggesting something is wring with the syntax.

Any ideas what am I doing wrong?

Daniil Penkin

Hi @golszewski-toolla,

Bitbucket Cloud uses CodeHilite for code highlighting in the markdown code blocks. It is configured to try guess code block language when it's not specified explicitly. What you see is a failure of guessing language (which is expected for your example as code blocks don't contain any code).

I'm not sure whether highlighting as an error in such case is what we actually want there, I'll raise this with the team.

Meanwhile, you can avoid misleading highlighting by adding explicit language text to your code blocks, like this:

```text
GET /lorem
```

``` text
Spaces between backticks and language name are fine too.
```

This should do the trick. Let me know if you have questions.

Cheers,
Daniil