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.
.vm
##