Text · AsciiDoc macro
Stop pasting a copy of the docs your repository already keeps
With the AsciiDoc macro you publish the .adoc itself - headings, tables,
admonitions and all - on the Confluence page. The wiki and the repository stop
disagreeing, because there is only one file, and nobody on your team maintains a sad
copy that quietly falls a release behind.
Nobody moves, and nobody maintains a second copy
Your engineers keep reviewing documentation in pull requests, where it belongs; everyone else reads it in Confluence, where they already are. Neither group changes its habits, and the second copy that used to drift a release behind simply does not exist any more.
Your manual still reads like a manual
You keep everything AsciiDoc carries that Markdown does not - nested sections, real tables, notes and warnings, cross-references - and it arrives formatted rather than as a wall of monospaced text. The structure your writers built survives the trip to the page.
You write release notes once and they stay current
Point the macro at the file your build already produces and every reader sees the current version whenever they open the page. The changelog, the specification and the API guide come from the source of truth, so nobody has to remember to copy them across - and nobody forgets to.
You publish from wherever the file lives, and readers keep their place
Type it into the macro, or point it at a URL, an attachment, a Git repository, Google Drive, or a credentialed S3, SFTP or database connection an admin set up once. Links open in a new tab by default so a reader never loses your page, and anyone who wants the raw AsciiDoc downloads it from the macro.
What the other AsciiDoc apps leave you doing by hand
The apps that publish AsciiDoc into Confluence are git-host integrations: one for Bitbucket, another for GitLab. If your documentation lives in the host they were built for, they work; if it lives in a release bucket your pipeline writes to, in Google Drive, behind SFTP or in a database, you are back to copying by hand. This macro treats the file as a file - any of those places, a repository or a plain URL - so where your team keeps documentation stays a decision about documentation, not about which app you bought.
AsciiDoc is one of 31 macros in Macro Pack
One app to install, one licence to renew, one place your team learns - and 30 more formats it already reads, from spreadsheets and diagrams to API specs and documents.
See every macro in the pack