about MyST-parser, es markdown pero rST

Jun 22, 2020

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

i was creating the docs for tacosdedatos-utils and i rather not touch rST ever. i had seen @choldraf tweet about MyST before but i had not had the need to use it.

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

Visit website

# sphinx # docs