## [Import Markdown into Confluence: Paste, GitHub, .md Files](/blog/import-markdown-into-confluence.md)

September 24, 2026 ·

<!-- -->

3 min read

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

Every team has Markdown lying around that Confluence needs: the README that became the service doc, the design doc drafted as a pull-request description, the runbook that lives in the repo. And every attempt to move it hits the same wall — Confluence's default editor does not parse Markdown. Paste a .md document and you get a wall of pipes, backticks, and asterisks that looks exactly like what it is: text nobody formatted.

The macro route dissolves the wall. Paste the document into a Markdown macro that actually parses it, watch it render in the preview pane, publish. This page is the workflow, end to end.

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [markdown](/blog/tags/markdown.md)
* [import](/blog/tags/import.md)
* [migration](/blog/tags/migration.md)
* [github](/blog/tags/github.md)
* [how-to](/blog/tags/how-to.md)
* [developer-tools](/blog/tags/developer-tools.md)

[**Read more**](/blog/import-markdown-into-confluence.md)