johno / pixyll

A simple, beautiful Jekyll theme that's mobile first
http://pixyll.com
MIT License
2.04k stars 1.34k forks source link

Footnotes are not rendering properly #306

Open thundergolfer opened 7 years ago

thundergolfer commented 7 years ago

I'm using the [^1] syntax in this post, but the footnotes are not rendering at all.

I did not altered the source of this project when I used it for my github.io website.

plttn commented 7 years ago

If I remember correctly, Github Pages's Markdown settings do not enable footnotes by default.

thundergolfer commented 7 years ago

@plttn It seems you are correct, this may not be an issue with pixyll.

bartekpl commented 7 years ago

@thundergolfer consider building your site locally and pushing only html to your github site dir. It is very easy to do (build takes just one additional cmd) + allows a lot of flexibility to customize what you get in html :).

mmistakes commented 7 years ago

@thundergolfer Footnotes work with GH Pages hosted sites. I think the issue is with your Markdown. Try removing the space before the colon like this as per Kramdown's syntax

[^1]: Data Engineering, Techopedia -  https://www.techopedia.com/definition/6730/data-architecture

There are also some Kramdown default options related to footnotes you can change in _config.yml, which GH Pages lets you override.