Apache Maven Doxia

Apache Maven Doxia is a content generation framework (documentation tooling) that parses various lightweight markup formats and renders them into multiple output formats, and is used as the documentation framework in Maven.

• Framework for parsing and rendering multiple markup languages (documentation tooling).
• Generates documentation in multiple output formats such as HTML and PDF (documentation publishing).
• Integrates as the documentation framework within Apache Maven site generation (build and release tooling).
• Provides a plugin and renderer architecture for extending supported input and output formats (extensibility framework).
• Supplies reusable components for documentation generation across Maven-related projects (developer tooling).

More About Apache Maven Doxia

Apache Maven Doxia is a content generation framework (documentation tooling) focused on converting lightweight markup formats into structured output formats for use in software documentation workflows. It operates as the documentation framework for Apache Maven, enabling automated generation of project sites and reference materials as part of standard build lifecycles. Doxia is designed so that tools can parse and render multiple markup syntaxes while maintaining a consistent document model.

The project provides core capabilities for parsing source documents written in supported markup languages (markup processing), transforming them into an Intermediate Representation (IR), and rendering that representation into formats such as HTML and PDF (documentation publishing). This model allows the same documentation sources to be reused across different output targets. Doxia implementations handle the syntax-specific details of each markup language while exposing a unified Application Programming Interface (API) to calling tools and plugins.

Within the Maven ecosystem, Doxia underpins site generation (build and release tooling). Maven plugins rely on Doxia to read documentation files from a project, apply rendering logic, and generate a browsable project site. This integration allows documentation generation to be invoked from the same build commands that compile, test, and package software, supporting repeatable documentation builds and alignment between code and documentation versions.

Doxia uses a modular architecture with pluggable parsers and renderers (extensibility framework). Parsers implement support for specific input syntaxes, while renderers produce target formats such as HTML or PDF. Additional modules and plugins can be added to expand supported markup languages or output types without altering existing tooling. This extensibility supports adoption in varied project environments that standardize on different documentation formats.

In enterprise and institutional settings, Doxia is used wherever Maven-based build pipelines also generate project documentation, reports, and sites (software lifecycle tooling). It supports centralized configuration through Maven project descriptors, making documentation generation part of Continuous Integration (CI) and release processes. Because Doxia operates as a library and framework, other tools in the Maven ecosystem can reuse its parsing and rendering capabilities to keep documentation processing consistent across projects.

From a directory and taxonomy perspective, Apache Maven Doxia fits into documentation tooling, build and Release Automation (RA), and developer tooling categories. It focuses on markup processing, content rendering, and integration with build systems, with particular alignment to Maven-based Java and JVM project ecosystems.