We've been working on a Sphinx extension that lets you write Sphinx docs in 💯 markdown (incl. roles and directives). We call it "MyST Markdown" (for "Markedly Structured Text"). Give it a shot, and please give feedback! myst-parser.readthedocs.io/e…
12
96
17
304
Replying to @choldgraf
MyST is getting more promising every day! I guess we will have to stick to reST for docstrings though? (Specially if we use napoleon and the NumPy docstring standard numpy.org/doc/stable/docs/ho…)

9:36 PM · Jun 15, 2020

1
0
0
2