Doxia Features

Table of Contents Macro

Generate a ToC from page headings:

<!-- MACRO{toc|fromDepth=2|toDepth=3|id=toc} -->

See Table of Contents^[1] for details.

Snippet Macro

Include code from external files:

<!-- MACRO{snippet|id=example|file=src/main/java/Example.java} -->

public class Example {
    // START SNIPPET: example
    public void doSomething() {
        System.out.println("Hello");
    }
    // END SNIPPET: example
}

<!-- MACRO{snippet|file=src/config/example.xml} -->

Echo Macro

Display the current date/time:

<!-- MACRO{echo|value=Today is ${currentDate}} -->

Useful for showing when documentation was generated.

Comments

Add comments that won't appear in output:

<!-- This is a comment and won't be rendered -->

Reference

• Maven Doxia Macros^[2] - Official documentation
• Doxia Markdown^[3] - Markdown module
• Maven Site Plugin^[4] - Site generation

Next Steps

• Page Structure^[5] - How to structure pages
• Maven Properties^[6] - Use pom.xml values
• Code Highlighting^[7] - Format code blocks
• Configuration Reference^[8] - All site.xml and front matter options