I’d like to see rST as an option for longer, more complicated documentation. Markdown is serviceable for simple prose, but the instant you need more than basic formatting, you’re on your own.
Maybe it would encourage adoption if there was a pure Rust implementation of rST that could be dropped into rustdoc… the one thing Markdown has over rST is that there are lots of implementations.