## [How to Write Markdown in Confluence — Syntax, Tables & Code Blocks](/blog/faq-confluence-markdown-editor.md)

May 2, 2026 ·

<!-- -->

12 min read

[NGPilot](https://ngpilot.com)

Who should read this

* **Developers and tech writers** who want to write Markdown in Confluence instead of the WYSIWYG editor
* **Teams migrating** README files, docs repos, or API references into Confluence
* **Anyone** who needs Mermaid diagrams or LaTeX math inside Markdown content

What you'll learn

1. Whether Confluence supports Markdown natively (and why it doesn't)
2. How to write Markdown with live preview, including code blocks, tables, and Mermaid
3. How Markdown content behaves after publish (search, exports, permissions)
4. When to use Markdown vs. Confluence's native WYSIWYG editor

Confluence's built-in editor is strictly WYSIWYG — there is no native Markdown editor. For teams who already write in Markdown (README files, docs repos, pull request descriptions), that means manually reformatting every doc through toolbar buttons, losing time and introducing inconsistencies. **Enhanced Markdown for Confluence** solves this by embedding a full Markdown editor with live split preview directly inside Confluence — and it renders Mermaid diagrams, KaTeX/LaTeX math, and 190+ code-highlighted languages, all in one macro.

This FAQ answers the questions teams ask most often about writing Markdown in Confluence.

**Tags:**

* [faq](/blog/tags/faq.md)
* [confluence](/blog/tags/confluence.md)
* [markdown](/blog/tags/markdown.md)
* [markdown-editor](/blog/tags/markdown-editor.md)
* [writing](/blog/tags/writing.md)

[**Read more**](/blog/faq-confluence-markdown-editor.md)