# Images in Markdown

GitHub, GitLab and Bitbucket blob/src links are automatically rewritten to their raw equivalents.

---

## Worth knowing

Images already on the Capable domain, on images.unsplash.com, or on an admin-approved egress domain skip the proxy. And anything that skips the proxy is blocked by the app's image policy, so it silently fails to load.

---

## Where to find it

Anywhere in a Markdown document

---

## Where you do it

| **Task**                                         | **Where**                            |
| ------------------------------------------------ | ------------------------------------ |
| Make the Markdown panel always visible on issues | Jira project settings > Issue layout |
| Add a Markdown document to an issue              | Issue view > Markdown panel > Add    |
| Read a Markdown document                         | Issue view > Markdown panel          |

---

## Settings that affect this

| **Setting**                 | **Where**                                                | **What it does** |
| --------------------------- | -------------------------------------------------------- | ---------------- |
| Sort tabs                   | Issue view > Markdown panel > sort button                | \-               |
| Getting started / List view | Apps > Capable Markdown > two icon buttons in the header | \-               |
| Project filter              | Apps > Capable Markdown > project selector               | \-               |

---

## Worth knowing

* Deleting a Markdown tab permanently deletes the underlying Jira attachment.

---

## Related

[Markdown search index (issue entity property)Another part of how this works.](https://help.gocapable.com/jira-markdown/markdown-search-index-issue-entity-property.html)

[Attachment triggers and queue consumerAnother part of how this works.](https://help.gocapable.com/jira-markdown/attachment-triggers-and-queue-consumer.html)

[How it worksThe rest.](https://help.gocapable.com/jira-markdown/how-it-works.html)

---

_How it actually behaves._