# Writing Markdown in Confluence

There are three ways Markdown usually arrives in Confluence: someone writes it there, someone has a .md file already, or the file lives in a repository. Each has a short guide below.

---

## Common tasks

| **You want to**                                | **Go to**                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Write Markdown on a page                       | [Write Markdown in Confluence](https://help.gocapable.com/markdown/write-markdown-in-confluence.html), then [Three-mode markdown editor](https://help.gocapable.com/markdown/three-mode-markdown-editor.html) |
| Bring in a .md file you already have           | [Import a Markdown file into Confluence](https://help.gocapable.com/markdown/import-a-markdown-file-into-confluence.html)                                                                                                                                                   |
| Show a README from GitHub, GitLab or Bitbucket | [Show a GitHub README in Confluence](https://help.gocapable.com/markdown/show-a-github-readme-in-confluence.html)                                                                                                                                                           |
| Draw a diagram in Markdown                     | [Diagrams from fenced code blocks](https://help.gocapable.com/markdown/diagrams-from-fenced-code-blocks.html)                                                                                                                                                               |
| See every setting of the macro                 | [Markdown](https://help.gocapable.com/markdown/markdown.html) and [Common tasks](https://help.gocapable.com/markdown/common-tasks.html)                                                                       |

---

## Guides in this section

[Write Markdown in ConfluenceWrite a Markdown document straight into a Confluence page with the Markdown macro and its edit, split and preview editor.](https://help.gocapable.com/markdown/write-markdown-in-confluence.html)[Import a Markdown file into ConfluenceBring a .md file from your computer into a Confluence page, either as an editable copy or as a rendered attachment.](https://help.gocapable.com/markdown/import-a-markdown-file-into-confluence.html)[Show a GitHub README in ConfluenceRender a README or any Markdown file from GitHub, GitLab or Bitbucket on a Confluence page, and keep it following the file.](https://help.gocapable.com/markdown/show-a-github-readme-in-confluence.html)

---

## Related

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

The behaviour worth understanding.

### [Sharing Markdown templates in Confluence](https://help.gocapable.com/markdown/sharing-markdown-templates-in-confluence.html)

Templates people reuse.

### [Frequently asked questions about Markdown in Confluence](https://help.gocapable.com/markdown/frequently-asked-questions-about-markdown-in-confluence.html)

Quick answers to common questions.

---

_However it arrives, it renders the same way._