You can write your documentation in Markdown…
If you want to filter content with Velocity (files ending in .vm), please have a look at explanations on Markdown conflict with Velocity on ## syntax.