I haven't seen anything in node-land that comes close to [Sphinx](http://sphinx-doc.org/) so I'd suggest making everything rST (not markdown) and moving the docs stuff you started below into Sphinx. We can already start by using the API directives like ``.. http:get::`` in [webpay](https://raw.github.com/mozilla/webpay/master/docs/services.rst). I know it would be lame to require python just for docs but we could make ``docs/requirements.txt`` and isolate it from everything else.