HI!

You can try it yourself. I tried and no, you cannot use it as a package. There is nothing about it in the documentation, and also you cannot use it in the way you mentioned.

MkDocs is not designed with this use case in mind. However, it should not be impossible to do. You would basically need to replicate the code in __main__.py. Note that you need to load the config yourself, and then pass that to the build function. build won't do that for you. And then each of the CLI commands corresponds to a file in mkdocs/commands/ (build, serve, etc). With a little spelunking through the code, you should get something that works.

A word of warning though. As we don;t document the internal structure of the code, we don't guarantee backward compatibility. Any future release could completely break your code.