FWIW, I went through the process of taking a “normal” markdown file and getting it into the build and wrote it up. It went pretty smoothly with minimal changes, for that doc at least. @jan is doing some fixes that should make the next one even smoother.
I was able to put the markdown file in the build with the changes outlined and not have to learn anything more than the /include command of latex.