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, then Three-mode markdown editor
Bring in a .md file you already have	Import a Markdown file into Confluence
Show a README from GitHub, GitLab or Bitbucket	Show a GitHub README in Confluence
Draw a diagram in Markdown	Diagrams from fenced code blocks
See every setting of the macro	Markdown and Common tasks

#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.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.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.

How it works

The behaviour worth understanding.

Sharing Markdown templates in Confluence

Templates people reuse.

Frequently asked questions about Markdown in Confluence

Quick answers to common questions.

However it arrives, it renders the same way.