myst-parser, es markdown pero rst
what i learned
MyST-parser is so easy to use and it provides all the functionality i need to make docs without using rST.
how i learned
today i made the documentation for that small utils package and it was actually a pleasant experience? the underlying concepts of rST (roles, directives, etc etc) are still a little fuzzy but the syntax makes a ton more sense now so it's one less challenge for me.
official docs: myst-parser.readthedocs.io