FindSoftware

ProperDocs

Static site generator for project documentation, written in Markdown and configured with a YAML file, forked from MkDocs.

ProperDocs is a static site generator for project documentation. Pages are written in Markdown, and a single properdocs.yml file sets the documentation structure, the theme and the plugin settings. The properdocs build command writes static HTML to a site folder, and any host that serves static files can serve it.

ProperDocs is a fork of MkDocs. It installs with pip, and the ProperDocs Team maintains it. Plugins and themes are listed in a catalog on GitHub.

The deployment guide covers GitHub Pages, Read the Docs and other static hosts.

Identity

Status
Active
Maintainer
ProperDocs Team1
Maintained by
Community
First release
20267

Rendering and deploy

Runs as
Static files5
Rendering
Static output1
Install with
pip3

Releases

Current major version
17
Last release
2026-03-207

Adoption

GitHub stars
3022
Contributors
2318
Downloads a month
1,636,1699

Why these figures do not compare

Sources

  1. 2026-10-23: links, Maintainer, Categories, Rendering
    properdocs.org/
  2. 2026-10-23: links, Written in, GitHub stars
    api.github.com/repos/ProperDocs/properdocs
  3. 2026-10-23: Runtime, Install with
    properdocs.org/user-guide/installation/
  4. 2026-10-23: Minimum runtime
    pypi.org/pypi/properdocs/json
  5. 2026-10-23: Runs as
    properdocs.org/user-guide/deploying-your-docs/
  6. 2026-10-23: License, License model, links
    github.com/ProperDocs/properdocs/blob/master/README.md
  7. 2026-10-23: First release, Current major version, Last release
    api.github.com/repos/ProperDocs/properdocs/releases
  8. 2026-10-23: Contributors
    api.github.com/repos/ProperDocs/properdocs/contributors
  9. 2026-10-25: Downloads a month
    packages.ecosyste.ms/api/v1/registries/pypi.org/packages/properdocs

Last reviewed · Updated · Listed since Edit on GitHubThis page as markdownas JSON