Have you looked at jupyter-book? The "native" format is MyST, which is markdown with extra things added in to customize behaviour of code blocks: https://jupyt

Have you looked at jupyter-book? The "native" format is MyST, which is markdown with extra things added in to customize behaviour of code blocks: https://jupyterbook.org/reference/cheatsheet.html https://jupyterbook.org/reference/cheatsheet.html I've been writing some stuff in MyST and I found it very productive. The ability to also support jupyter notebooks is also interesting.