A mini audio player plugin for Jekyll


A minimal audio plugin for Jekyll.

The implementation is based on HTML5 audio element (without fallback support for flash), so a morden browser is expected.

Audio formats support also depends on browsers, but generally mp3, wav, ogg are supported.

See Live Demo


  • In your Jekyll project's Gemfile:
      group :jekyll_plugins do
          ...   # other plugins
          jekyll-miniaudio # add here
    then bundle install.


This plugin is a Jekyll Tag, you just pass either an audio link or file path.

  • Use with audio link:

    {% miniaudio 'https://somewhere/themusic.mp3' %}

  • Use with file path. For example if you have a demo.ma3 located in your assets/music folder, then just put:

    {% miniaudio '/assets/music/demo.mp3' %}

    ** Note: Ensure your file is accessible via http(s)://YOUR_HOST/assets/demo.mp3**

Issues and feature requests

Feel free to create issues or send me email


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer

Get New Themes & Resources