title: How to use markdown for maven project site?
body: <p>How to start with project documentation using maven and markdown markup language?
  Maven site default is APT, which is uncomfortable to learn just to do thing maven way.
  (Usually nobody in a team will start writing maven site documentation when they also need to learn one more markup language along the way.)</p>
  
  <p>Has anybody tried to use markdown (the same markup language as used on github) for Maven project site documentation? I see from <a href="http://maven.apache.org/doxia/references/index.html">Maven Doxia references</a> that it is possible.
  Any issues?</p>
  
  <p>I am new to maven site generation. I think markdown is better to start with, than others markup languages, that the team has not worked with.</p>
  
  <p>UPDATE. Succeeded. See answer below.</p>