We have *.md files in our Bitbucket repo that contain images. We typically put the images in an images subdirectory.

For, example:

• images/logo.png
• README.md contains 

This older issue discussed the original problem:
BCLOUD-6589

The recent broken markdown images are due to a regression when turning on the New source browser experience via setting on Labs page.

Expectation: When rendering markdown, the relative path in an image link should be rewritten so that the web browser loads the raw version of image and not the image viewer HTML page.