mkdocs-timetoread-plugin

mkdocs-timetoread-plugin is a lightweight 'estimated time to read' generator for MkDocs inspired by @alanhamlett's readtime and Medium's read time formula.

Setup

Install the plugin using pip:

pip install mkdocs-timetoread-plugin

Activate the plugin in mkdocs.yml:

plugins:
  - search
  - timetoread

Note: If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.

mkdocs.yml Configuration

wpm - Sets the 'words per minute' value for calculating estimated read time.
- Default value is 255
- Possible value range: 1 - 999
allPages - Sets all markdown files to have their read times' calculated unless explicitly disabled in the files' Front Matter.
- Default value is True
- Possible values: True or False
textColor - Sets the CSS color for styling the 'Estimated read time:' text.
- Default value is bdbdbd
- Possible value range: 000000 - ffffff

Example Configuration

plugins:
  - timetoread:
      wpm: 190
      allPages: True
      textColour: 000000

Front Matter

Other configuration options are available by defining the following in a YAML front matter block in each markdown file.

// Disable timetoread on a per file basis if `allPages is set to True
timetoread: False

// Enable timetoread on a per file basis if `allPages` is set to False
timetoread: True

Usage