Comment formatting on Gerrit

I've spent a while this morning looking for the markup for Gerrit comments.

It seems that this isn't a well documented markup, so I'm posting a record of my discovery here!

http://review.whamcloud.com is used to help the code review workflow at Whamcloud. I find this to be an excellent tool. One feature I like is you can make individual in-line comments against specific lines of a change-set.

This is really handy to explain what needs to change - and why I have (reluctantly) given a -1 score.

So, If you find yourself doing similar, you may want to include a formatted comment. Up until now, I didn't know how. That all changed when I found a helpful thread on groups.google.com.

The thread helpfully explains you can (at least) use (undocumented) markup to do the following:

* item a
* item 1
* item

# item a
# item 1
# item

 paragraph starting
with a space
 preserves
formatting

 paragraph starting
with a space
 preserves
formatting