# Frequently asked questions about Markdown in Jira Short answers to the questions we hear most, each with a link to the page that explains it properly. --- ## Writing ### How do I use Markdown in a Jira issue? Open the issue's Markdown panel, click **Add**, write with the live preview and click **Save**. See [Use Markdown in a Jira issue](https://help.gocapable.com/jira-markdown/use-markdown-in-a-jira-issue.html). ### Where are the documents stored? Each document is a .md attachment on the issue, so it follows Jira's attachment permissions and shows in the issue's attachments too. ### Can I upload images into a document? No. Reference images by web address, or use **Insert**, **From web**. Relative paths from a repository do not resolve in Jira. See [Images in Markdown](https://help.gocapable.com/jira-markdown/images-in-markdown.html). ### Which diagram languages are supported? 28, including Mermaid, PlantUML, Graphviz and D2, written as fenced code blocks. See [Add a diagram to a Jira issue with Markdown](https://help.gocapable.com/jira-markdown/add-a-diagram-to-a-jira-issue-with-markdown.html). ### Why did picking a template wipe what I had typed? Choosing a template replaces the title and the whole body. Pick the template first, then write. See [Start a Jira Markdown document from a template](https://help.gocapable.com/jira-markdown/start-a-jira-markdown-document-from-a-template.html). --- ## Managing and finding ### Does deleting a tab delete the file? Yes. Deleting a Markdown tab permanently deletes the .md attachment from the issue. See [Edit or delete a Markdown document in a Jira issue](https://help.gocapable.com/jira-markdown/edit-or-delete-a-markdown-document-in-a-jira-issue.html). ### Why did the tab order change for everyone? The sort order is saved on the issue, not per person, so whoever last clicked the sort button set it for all. ### Why does the Capable Markdown page show no results? It lists issues the app has indexed, and an issue is indexed when a .md file is added to or removed from it. Files attached before the app was installed appear once a .md file is next added to or removed from that issue. See [Find Markdown documents across Jira projects](https://help.gocapable.com/jira-markdown/find-markdown-documents-across-jira-projects.html). --- ## Access and export ### Why do logged-out viewers see nothing? The Markdown panel and the global page are shown to logged-in users only. See [Logged-out or anonymous viewers see nothing from the app](https://help.gocapable.com/jira-markdown/logged-out-or-anonymous-viewers-see-nothing-from-the-app.html). ### Why is the Markdown missing from a Jira export or PDF? Jira's export does not include app panels. Download the .md attachments from the issue instead. See [Panel content is missing from a Jira export or PDF](https://help.gocapable.com/jira-markdown/panel-content-is-missing-from-a-jira-export-or-pdf.html). ### Can I restrict who can add Markdown? Not in the app. Anyone who can add attachments to an issue can add a document, so use Jira's attachment permissions. See [the troubleshooting page](https://help.gocapable.com/jira-markdown/cannot-restrict-who-adds-markdown-or-configure-diagram-languages.html). --- ## Related ### [Writing Markdown in Jira issues](https://help.gocapable.com/jira-markdown/writing-markdown-in-jira-issues.html) Adding documents and diagrams. ### [Managing Markdown documents in Jira](https://help.gocapable.com/jira-markdown/managing-markdown-documents-in-jira.html) Edit, delete and find documents. ### [Troubleshooting](https://help.gocapable.com/jira-markdown/troubleshooting.html) 23 symptoms, grouped by where they bite. --- _Not here? The troubleshooting pages go deeper._