3 ms·

MySt and sphinx are getting attentions these days. As a ascii doc lurker, and fed up of rst, I'm very hopeful.

• rk06 5y ago
  Sphinx & rst combo is great in theory. in practice, it has a big learning curve and the python tooling is not the fastest option. I had tried it once in my previous job, and people do not want to learn it, or spend time with doc related stuff That makes me appreciate markdown a lot, As it is easier to pick up. And has fantastic tooling. And there is at least one md to html project, which will be in your language of choice
  • masklinn 5y ago
    Yeah rST is theoretically nice but being both permissive and extremely whitespace-sensitive makes it very fiddly in practice, with inscrutable warnings and many mis-compiled documents with no warnings or information. Some of the markup choices were really less than ideal in retrospect, especially indentation for quoting and definition lists (though it’s nice to have definition lists), even more so given the aforementioned whitespace sensitivity. Really hard to beat as a thing to build around, but that also greatly limits the ability to process or reimplement it.
  • BiteCode_dev 5y ago
    Hence MyST.