Images in Markdown
Images in a Markdown document are referenced by web address. GitHub, GitLab and Bitbucket blob/src links are automatically rewritten to their raw equivalents, so you can paste the link you see in your repository.
#Worth knowing
While you are signed in, images on most websites are fetched through Capable's image proxy so they can display inside Jira. Images on Capable's own domain and on images.unsplash.com load directly.
#Where to find it
Anywhere in a Markdown document
#Where you do it
Task | Where |
|---|---|
Add an image | Editor > Insert > From web, or Markdown image syntax with a web address |
Read a Markdown document | Issue view > Markdown panel |
#A few things that catch people out
There is no image upload from the editor. Images must be referenced by a full web address.
Relative paths, such as
./diagram.png, do not resolve in Jira.An image that cannot load is replaced by '[Image failed to load: ...]', or '[Image load timed out: ...]' after 15 seconds, with its alt text or address.
Image-heavy documents load in waves, because at most 20 images are fetched at once.
#Related
How it actually behaves.
