Skip to main content

Confluence: Markdown vs WYSIWYG — FAQ

· One min read
NGPILOT

Q: Can I use Markdown in Confluence? A: With the right app/plugin (or by using MDX-powered docs), yes. Native Confluence editor is WYSIWYG.

Q: When to use Markdown instead of WYSIWYG? A: Use Markdown for versioned content, programmatic generation, or when contributors prefer plain text.

Q: Will Markdown export nicely to PDF or HTML? A: Yes, but check the some macros or extensions may not translate perfectly.renderer

Q: Do macros work inside Markdown? A: Depends on the plugin. Some Markdown apps support a macro syntax or mappings to Confluence macros.

Q: How to migrate existing WYSIWYG pages to Markdown? A: Export content to storage format or copy/paste and manually adjust; test thoroughly.

Q: Best practices? A: Keep short sections, use code blocks for snippets, and prefer templates for repetitive content.