I have markdown files in a git repo and run mdbook via cicd so I get a nice html build. Localy I can build it too or just use the markdown files (except for mdbook specific features such as preprocessors).