Open Water Foundation / Learn MkDocs

This documentation provides resources to learn how to to use the MkDocs software, which creates static websites from Markdown sourcefiles. Such documentation can be developed with software projects and other projects and can be deployed to the cloud for web-accessible documentation.

This documentation has been written based on experience using MkDocs at the Open Water Foundation.

About the Open Water Foundation

The Open Water Foundation is a 501(c)3 nonprofit social enterprise that focuses on developing and supporting open source software for water resources, so that organizations can make better decisions about water. OWF has created this documentation to educate its staff, other developers, and clients that use MkDocs for documentation.

See also other OWF learning resources.

How to Use this Documentation

The documentation is organized in order of information and tasks necessary to setup a development environment and use MkDocs software.

This documentation is not intended to be a full reference for MkDocs but focuses on important topics that will help a understand important technical concepts and be successful with MkDocs.


The OWF Learn MkDocs website content and examples are licenses under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Source Repository on GitHub

The source files for this documentation are maintained in a GitHub repository: owf-learn-mkdocs.


This documentation is prepared using MkDocs. For full MkDocs documentation visit