Skip to content

Export to HTML

After enabling the print-site plugin in your mkdocs.yml, you will have your entire site combined into a single page.

That allows you to create a standalone HTML page: a single self-contained file that has all images, styling and scripts embedded. This means you could send a site as an email attachment, a use case common within companies where deploying static sites might be more involved. This works because all the resources the page uses, such images, stylesheets (CSS) and interactive elements (javascript) are embedded into in a single HTML file using data URLs.

You can create a .html file export using your internet browser (f.e. save as > webpage, single page). You can also do this programmatically, for example using the htmlark python package:

pip install htmlark[http,parsers]

To create the export:

mkdocs build
cd site/

# when mkdocs.yml has use_directory_urls: true (the default)
htmlark print_page/index.html -o standalone.html

# when mkdocs.yml has use_directory_urls: false
htmlark print_page.html -o standalone.html