News for hackers. Stuff that matters.
Re:Thoughts on Markdown by BiteCode_dev on Monday February 21, 2022 @07:14AM (#30414960)
MySt and sphinx are getting attentions these days. As a ascii doc lurker, and fed up of rst, I'm very hopeful.
Re:Thoughts on Markdown by rk06 on Monday February 21, 2022 @07:35AM (#30415180)
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

Re:Thoughts on Markdown by masklinn on Monday February 21, 2022 @07:48AM (#30415304)
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.

Re:Thoughts on Markdown by BiteCode_dev on Monday February 21, 2022 @08:12AM (#30415514)
Hence MyST.