I feel the same way about RST; really wanted to like it, fought with it, gave up because Sphinx consistently seems to make simple things hard. Regarding sectio

I feel the same way about RST; really wanted to like it, fought with it, gave up because Sphinx consistently seems to make simple things hard. Regarding section titles, I think the theory is it makes it easier to stick new header levels into a document. (For those who aren't familiar with RST: If it sees underlines like ====, ----, ^^^^ or ~~~~~, it decides what the header levels are based on the order in which it sees them.) In practice, it means a typo makes it completely ignore your header, you have to learn a set of acceptable characters for headers, and there's no way to start a document with anything less than shouty H1. Nice idea, though. > Is there a markup that can do numbered lists? Correctly and usably? NOPE.