Re:Why I Prefer RST to Markdown
by asmeurer on Wednesday July 31, 2024 @03:12PM
(#41122394)
The author claims that RST is nice because it's extensible, but as someone who's written some Sphinx extensions, I can tell you that extending RST is not as pleasant of a task as the author makes it out to be. I don't really know what it's like in Markdown world, but the underlying tools (Sphinx and docutils) are very difficult to work with, and make many implicit assumptions that make certain things difficult or impossible.
[ Parent
| on HN ]
Re:Why I Prefer RST to Markdown
by romanovcode on Wednesday July 31, 2024 @03:42PM
(#41122715)
I think author should write HTML if they want extensibility so much. Not like RST is reading-friendly to begin with.
Re:Why I Prefer RST to Markdown
by ideasman42 on Wednesday July 31, 2024 @09:35PM
(#41125396)
Keep in mind you might not _only_ be exporting HTML.
Re:Why I Prefer RST to Markdown
by ideasman42 on Wednesday July 31, 2024 @09:35PM
(#41125391)
I've written a few Sphinx extensions ... it seemed OK to me, a bit awkward but long term - this is the kind of thing you do rarely & use often, so how nice it is to write extensions is barely an issue.