Convert core documentation to markdown

Converts documentation of core source files to use markdown formatting,
which is cleaner and easier to read than RDoc's default format.

When creating documentation, use:

rdoc --markup=markdown