Skip to main content

An MkDocs plugin. Generates thumbnails of PDF files and YouTube links.

Project description


MkDocs plugin to generate thumbnails automatically.

Provides a mechanism to indicate, in Markdown, the desire for PDF files and YouTube links to have a thumbnail image, automatically generated/downloaded.


Install the plugin using pip:

pip install mkdocs-thumbnails

Activate the plugin in mkdocs.yml. Include the attr_list extension as shown here:

  - search
  - thumbnails:
      # optional styling for the thumbnail:
      style: margin-top:5px;margin-bottom:5px;margin-right:25px  

    - markdown.extensions.attr_list 

Note: The extension 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.

More information about plugins in the MkDocs documentation.


  • style - This is the CSS style to be set in the thumbnail's image tag


In the attribute list of a link, add .pdf or .youtube to turn on the thumbnail for that link.

# Some example markdown text

* [My PDF file](foo.pdf){.pdf}
* [A YouTube video link]({.youtube}

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-thumbnails-0.0.4.tar.gz (4.9 kB view hashes)

Uploaded source

Built Distribution

mkdocs_thumbnails-0.0.4-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page