Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Bigfoot.js Plugin

The Bigfoot.js Plugin is for Grav CMS. Loads the Bigfoot.js script (and jQuery if required) to enable better Footnotes.


Installing the Bigfoot Js plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.

GPM Installation (Preferred)

The simplest way to install this plugin will be via the Grav Package Manager (GPM) through your system's terminal (also called the command line). Currently the plugin isn't available through GPM so you the manual option will have to be used in the short term. From the root of your Grav install type:

bin/gpm install bigfoot-js

This will install the Bigfoot Js plugin into your /user/plugins directory within Grav. Its files can be found under /your/site/grav/user/plugins/bigfoot-js.

Manual Installation

To install this plugin, just download the zip version of this repository and unzip it under /your/site/grav/user/plugins. Then, rename the folder to bigfoot-js. You can find these files on GitHub or via

You should now have all the plugin files under


NOTE: This plugin is a modular component for Grav which requires Grav and the Error and Problems to operate.


Plugin settings

From the plugins settings screen in the Grav Admin you can:

  • Enable/Disable the Bigfoot.js plugin
  • Enable/Disable autoloading of Bigfoot.js
  • Select from the 'Default', 'Number' or 'Bottom' style of footnotes

Manual Configuration

Before configuring this plugin, you should copy the user/plugins/bigfoot-js/bigfoot-js.yaml to user/config/plugins/bigfoot-js.yaml and only edit that copy.

Here is the default configuration and an explanation of available options can be found below:

enabled: true
include_jquery: false
auto_bigfootjs: true
style: default


Creating Footnotes in Markdown

Everyone know that Grav supports Markdown and Markdown Extra?

Markdown Extra provides support for Footnotes šŸ˜ƒ

To enable Markdown Extra, login to your Grav websites Admin area and go to Configuration->System and turn on Markdown Extra.

Or enable it manually, in user/config/system.yaml set the markdown: -> extra: to true, the section should look something like this:

    extra: true
    auto_line_breaks: false
    auto_url_links: false
    escape_markup: false
      '>': gt
      '<': lt

Right now there's only two options, the first is to enable automatic detection of Markdown Extra style footnotes and add Bigfoot.js to the page when it does detect them. I recommend leaving this On right now as it won't work without being turned on.

The second option is to include jQuery, this defaults to off. You probably won't need this as most themes include jQuery and the Grav core includes it as well, but if you use a theme that doesn't load jQuery into your pages this will add it for you.

Footnote Syntax

The syntax for adding footnotes is suitably simpleā€¦ in the Markdown style:

This is some text with a footnote at the end.[^1]

[^1]: And this is the footnote.

Footnotes can contain a reasonable range of content and like any good footnote system you don't have to keep them in order (one can be after two for example). In fact most markdown will work in a footnote e.g.

[^6]: You've already seen:
* links
* text styling
* and now lists
[^7]: It also support imagesā€¦ ![](Icon_Craig.jpg)


Of course this wouldn't be possible without Bigfoot.js and Markdown Extra, all my efforts are trivial by comparison.

To Do

  • settings for controlling the footnote mark option (right now its the default elipses [^3], soon you have numbers available as well)
  • the ability to add your own CSS styling to your theme for automatic overriding of the default style
  • and controls for changing the other options in Bigfoot.js


A Grav plugin that adds BigfootJS to your pages.








No packages published