MathJax in template enabled by `rdoc` command line option

Ok, I know this is a particular and difficult thing to request. I hope you'll not hate me for this. But in my University, Ruby is used as first language for students because of its expressiveness. The course is focused on numerical methods implemented in Ruby (not efficient, I know, but easy enough to allow student to understand concepts).

For me it will be really cool if rdoc allows to insert equation using markdown parser, rendered through MathJax in final HTML product (maybe using something like rdoc --markup markdown-with-math ...).

I know it could be possible to add this through an ah-hoc template, but I think that as a new feature could be really useful, also for the guys at SciRuby.

What do you think?

Start by tracing how the rdoc command-line options select markup and how an ad-hoc template affects final HTML. Define the behavior of a markdown-with-math option, including equation handling through MathJax, and verify that generated documentation renders the requested equations.