Published 2025-11-08.
Time to read: 1 minutes.
jekyll_plugins collection.
jekyll_kramdown allows a mixture of HTML and any
supported flavor of Markdown in the same file.
Defines a kramdown block tag that processes
Kramdown (a flavor of Markdown) embedded in
HTML files.
This plugin uses the facilities of the
kramdown plugin.
Installation
Add the following to your Jekyll website’s Gemfile:
group :jekyll_plugins do
gem 'jekyll_kramdown'
end
And then execute:
$ bundle
Options
Invocation options
The available options for the kramdown block tag are:
noauto_idsDo not generateidtagshard_wrapEnable GitHub wrapping defaultinput=GFMSpecify flavor of markdown (case sensitive)math_engine=katexSpecify math engine (case senstitive)syntax_highlighter=rougeSpecify highligher (case sensitive)table-containerWrap the output within<div class="table-container"></div>
Here they are all used together:
{% kramdown noauto_ids hard_wrap table-container
input=GFM
math_engine=katex
syntax_highlighter=rouge %}
## Subheading here
- This is a perfectly good point
- YAP (yet another point)
{% href label='This link was generated by a Jekyll Support plugin.'
url='https://www.mslinn.com/jekyll_plugins'%}
{% endkramdown %}
The above example shows the jekyll_href tag plugin being used within kramdown text, which was embedded in an HTML page.
Document Options
Kramdown options can be specified in the content to some degree and with some fussing.
Usage
Add the following in any HTML file within a Jekyll project:
{% kramdown %}
## Heading
Some text
- option 1
- option 2
{% endkramdown %}
Modify _config.yaml to set kramdown options.
I recommend these:
kramdown:
input: GFM
hard_wrap: false
markdown: kramdown
