Good news though, the jupyter devs created myst (https://myst-parser.readthedocs.io/en/latest/syntax/syntax.h...), a superset of markdown that has almost all the features of rst, and can embed rst when it falls short.
And there is a plugin to use it with sphinx. It can even reside in a project that started with rst files, both format can coexist.
With this and sphinx-autoreload, writing doc is so much better.
Good news though, the jupyter devs created myst (https://myst-parser.readthedocs.io/en/latest/syntax/syntax.h...), a superset of markdown that has almost all the features of rst, and can embed rst when it falls short.
And there is a plugin to use it with sphinx. It can even reside in a project that started with rst files, both format can coexist.
With this and sphinx-autoreload, writing doc is so much better.