We have an older section that encourages ReST, though we wanted to use markdown; only document headlines (the first one on top) really need to be written in ReST now as far as I understand the Sphinx docs. I'm not sure about remarks (| Warning: Be sure to read this carefully |).

The file in question is collaborate/Readme.md.