This is sample code for doxia-module-markdown
download from doxia-module-markdown first and install locally, probably it will exist in maven repo later.
mvn site
It should work as normal mvn site
Then you can check the src/site/site.xml
and files under src/site/markdown
I reported some issues in web, hopefully it can be enhanced, so far so good