.png&w=64&q=75 "PDF Exporter for Confluence")
What changes for your docs
- Writing
READMEs pasted into the editor lose their tables and code formatting.
Write Markdown on the page with live preview, or import .md files as a page tree.
- Keeping in sync
Someone copies docs from Git by hand, and Confluence is stale by the next release.
CI publishes the docs to Confluence on every merge.
- Math and examples
Formulas are screenshots, and interactive examples live somewhere else.
LaTeX renders on the page, and HTML, CSS and JavaScript examples run inside it.
- Sharing outside
Customers get a Confluence login or a PDF that loses the layout.
One branded PDF of a whole page tree, or Markdown for their own repo.
How teams run technical docs in Confluence
Four steps, each done by one app. Use the ones you need; they work on their own.
Write in Markdown on the page
A split editor with live preview, GitHub-flavoured tables and task lists, code highlighting and KaTeX math. The Markdown source stays editable.
Markdown Macro+ for Confluence
Import existing docs and publish from Git
Bring in a file, a folder or a ZIP; folders become parent pages. Then publish from CI through the REST API on every push, with tokens that expire after 1 to 30 days.
Markdown Importer for Confluence CloudAdd equations and live examples
Inline and block LaTeX rendered by KaTeX, and HTML, CSS and JavaScript embeds with version history and a content security policy you control.
LaTeX Math for ConfluenceShare it outside Confluence
Turn a page tree or a whole space into one PDF with a cover, table of contents and watermark, or export it back to Markdown for Git and Obsidian.
.png&w=48&q=75)
PDF Exporter for Confluence
The apps
Each one installs on its own from the Atlassian Marketplace and runs on Atlassian Forge.
- Markdown Macro+ for Confluence
Write Markdown with live preview
Markdown Importer for Confluence CloudImport .md files and publish from CI
LaTeX Math for ConfluenceEquations and chemistry notation
HTML Macro+ for ConfluenceLive HTML, CSS and JavaScript embeds
.png&w=96&q=75)
PDF Exporter for ConfluenceBranded PDFs of pages, trees and spaces
Markdown Exporter for ConfluenceConfluence back to Markdown
Confluence on its own, and with these apps
| Need | Confluence on its own | With the apps |
|---|---|---|
| Keep docs as Markdown | Markdown shortcuts while typing, but no Markdown source is kept | Markdown source on the page, with live preview |
| Bulk import .md files | Not built in | Files, folders or a ZIP, as a page tree |
| Publish from Git or CI | Not built in | REST API with expiring Bearer tokens |
| LaTeX equations | No LaTeX macro in Cloud | Inline and block KaTeX, with live preview |
| Embed HTML and JavaScript | No HTML macro in Cloud | HTML, CSS and JS with CSP controls |
| PDF of a page tree | Limited control over layout | One merged PDF with templates, cover and TOC |
| Export to Markdown | Not built in | Pages, trees or spaces, with front matter |
Questions
Is Confluence good for technical documentation?
For internal docs, yes: it is where the rest of the company already works, and permissions, search and page history come with it. The gaps are the things engineers rely on, namely Markdown, a link to Git, math and controlled exports. Apps close those gaps without moving the docs anywhere else.
Can I write Markdown in Confluence Cloud?
The editor accepts some Markdown shortcuts but does not keep Markdown source. Markdown Macro+ adds a macro where you write Markdown in a split editor with live preview, and the source stays editable afterwards.
How do I keep Confluence in sync with docs in GitHub or GitLab?
Keep the Markdown in the repository and publish it from your pipeline. Markdown Importer has a REST API that creates or updates a page per request, so a CI job can push the docs to Confluence on every merge.
Can I add LaTeX equations to Confluence?
Not natively in Cloud. LaTeX Math for Confluence adds inline and block macros rendered with KaTeX, including chemistry notation with \ce{}.
How do I export Confluence documentation as a PDF for customers?
PDF Exporter turns a page, a page tree or a whole space into one merged PDF, using templates your admins manage, with a cover page, headers and footers, page numbers, a table of contents and an optional watermark.
Do these apps send our documentation to another server?
No. Every app is built on Atlassian Forge and carries the Runs on Atlassian badge, so it runs on Atlassian's infrastructure and your content stays on your Atlassian site.
From the blog
How to Use Confluence as a Developer Wiki
When Confluence is the right developer wiki, how to structure it, which templates to use, and how to keep engineering docs current so people trust them.
How to Document APIs in Confluence
API docs end up scattered across READMEs, Postman and Swagger. Here's how to centralize them in Confluence and keep them up to date.
How to Sync Docs from GitHub to Confluence Automatically
Keep Markdown docs in GitHub and Confluence in sync with a GitHub Actions workflow that pushes changed files through the Markdown Importer REST API.