Comment by runningmike

I would strongly recommend MyST. MyST extends Markdown for technical and scientific communication. See https://www.myst.tools/