Antora
Antora builds documentation websites from AsciiDoc stored in Git repositories, with multi-repository content aggregation, documentation versions, configurable playbooks, and static publishing.
About Antora
Antora is an open-source documentation site generator for teams writing in AsciiDoc. It gathers content from one or more Git repositories and assembles that material into a documentation website.
Documentation versions can follow repository branches, while a playbook specifies the content sources, website interface, and output configuration. Antora separates content from presentation and generates static pages that can be published through an automated workflow.
Key Features
- AsciiDoc Authoring: Build documentation websites from AsciiDoc source files.
- Multi-Repository Aggregation: Assemble documentation from multiple Git repositories.
- Versioned Documentation: Collect and publish documentation versions associated with repository branches.
- Playbook Configuration: Define content sources, interface settings, and publishing options in a playbook.
- Repository Access Options: Collect content from supported local, remote, public, and private repositories.
- Static Site Output: Convert source content and UI templates into a static documentation website.
Pricing
- Open-Source Software: Free under the Mozilla Public License 2.0. Antora is available as open-source software. Repository hosting, website hosting, and any separately obtained services are outside the core generator.
Use Cases
- Combining documentation maintained across multiple repositories
- Publishing documentation for multiple product versions
- Managing AsciiDoc-based technical documentation
- Automating documentation builds within Git-based workflows
Pros & Cons
Pros:
- Aggregates documentation across multiple Git repositories
- Supports versioned documentation collections
- Separates content sources, configuration, and presentation
Cons:
- Content must follow the project structure Antora expects
- Its documented authoring workflow uses AsciiDoc
Integrations
Git, AsciiDoc, Node.js, GitHub, GitLab, Bitbucket
FAQ
What is Antora?
Antora is an open-source documentation site generator that assembles AsciiDoc content from Git repositories into a website.
Is Antora free?
Antora is open-source software licensed under the Mozilla Public License 2.0. Hosting and external services are separate.
Can Antora combine multiple repositories?
Yes. Antora can gather documentation content from one or multiple Git repositories.
What does an Antora playbook do?
A playbook describes the content sources, user interface, and other configuration needed to generate a documentation website.
Can Antora publish multiple documentation versions?
Yes. Antora can collect content from repository branches and assemble versioned documentation collections.
Last edited
November 3, 2026 at 10:21 AM by Venkatraman Chandrasekaran
