Skip to content

MkDocs quickstart

[Homepage | mkdocs.org] [PyPI | mkdocs] [Github | mkdocs/mkdocs]

This is designed to get you up and running as quick as possible.

  1. Install mkdocs:

    pip install mkdocs
    
  2. Create a new mkdocs project:

    mkdocs new .
    

  3. Remove docs/index.md and copy your notes into the docs directory.
  4. Serve the site with mkdocs to see if it looks OK.
  5. Optional: Improve the site by adding plugins, themes, updating mkdocs.yml, etc.
  6. Deploy the site. For example by building it with mkdocs build and uploading the site directory to your server's web root.

The following pages link to this page: