# Edit or delete a Markdown document in a Jira issue

To edit a Markdown document in a Jira issue, select its tab in the **Markdown** panel, click **Edit**, make your changes and click **Save**. To delete one, click the bin on its tab and confirm with **Delete**. Deleting removes the .md attachment from the issue for good, so download a copy first if you might need it.

---

## Before you start

* You need to be allowed to add and delete attachments on the issue.
* Saving an edit replaces the attachment with a new one, so the issue history shows an attachment deleted and added.

---

## Steps

1. Open the issue and select the document's tab in the **Markdown** panel. Hidden tabs are under **More**.
2. To change it, click **Edit**. Change the **Title** to rename it, edit the body, and click **Save**.
3. To delete it, hover its tab, click the **Delete** bin icon, and click **Delete** in the **Delete Markdown** dialog.
4. To reorder the tabs, click the sort button next to **Edit** to switch between newest first and A to Z.

![](https://help.gocapable.com/images/530e3e45-e4dc-4c09-be77-ce15a33ba992.webp)

Editing a document from the Markdown panel. Change the Title to rename it, edit the body, then click Save.

---

## If it does not work

* **The sort button is missing.** It is hidden when the panel is narrow. Widen the window.
* **Someone else changed the tab order.** The order is saved on the issue for everyone, not per person.
* **Two tabs now have the same name.** Renaming saves a new file under the new title. Give each document a distinct title.

---

## Related

### [Markdown (issue panel)](https://help.gocapable.com/jira-markdown/markdown-issue-panel.html)

The issue panel in full.

### [Document disappeared after saving an edit, with no error shown](https://help.gocapable.com/jira-markdown/document-disappeared-after-saving-an-edit-with-no-error-shown.html)

Why an edit replaces the attachment.

### [Managing Markdown documents in Jira](https://help.gocapable.com/jira-markdown/managing-markdown-documents-in-jira.html)

More guides for managing documents.

---

_Keep the issue's documents as current as the issue._