Steve Stone

Developer. Designer. Youth Worker. Nerd.

Top 3 Kramdown Extras
May 2, 2015

Markdown is awesome and definitely one of the main reasons why I wanted to start blogging in Jekyll (yes, I know you can do Markdown in other platforms, but this is a little more literal which is why I think I like it).

That said, I'm exploring other extra markdown features that I can do on my site, so I decided to list a few of my favorites. I'm using kramdown as my markdown processor. It's the one that came with my theme so I can't say whether it's better than redcarpet or not, but I'm oblivious as of the moment.

1. Footnotes

... a footnote marker can be created by placing the footnote name in square brackets. The footnote name has to start with a caret (^), followed by a word character or a digit and then optionally followed by other word characters, digits or dashes.

For example: This is some text.[^1] translates to:

This is some text.[^1]

Where you want the footnotes to show up, simply put:

[^1]: Some *crazy* footnote definition.

{::comment} This text is completely ignored by kramdown - a comment in the text. {:/comment}

(Look are the bottom of this page to see the rendered footnote)

So far my favorite way to make links is a inline, using a reference number, and then creating a list at the bottom of my page.

For example: Here is a link to [Google][1]. translates to: Here is a link to Google.

At the bottom of the page, simply define the links: [1]: http://google.com

3. Blockquotes

To make a blockquote, simply type a > marker and then the quote

For example:

> “True humility is not thinking less of yourself; it is thinking of yourself less.”
> <cite>-― C.S. Lewis, *Mere Christianity*</cite>

translates to:

“True humility is not thinking less of yourself; it is thinking of yourself less.” -- C.S. Lewis, Mere Christianity


[^1]: Some crazy footnote definition.