Use Markdown dentro de blocos HTML em Jekyll

Não posso levar os créditos pelo código, mas ele foi tão útil para mim como um novo desenvolvedor Jekyll que preciso compartilhá-lo.

Jekyll pode ser facilmente estendido usando plug-ins. Simplesmente crie um diretório na raiz do seu site chamado _pluginse adicione seus plug-ins lá. Veja a documentação da jekyll para mais informações.

Eu encontrei o plug-in de redução neste Post StackOverflow .

module Jekyll
  class MarkdownBlock < Liquid::Block
    def initialize(tag_name, text, tokens)
      super
    end
    require "kramdown"
    def render(context)
      content = super
      "#{Kramdown::Document.new(content).to_html}"
    end
  end
end
Liquid::Template.register_tag('markdown', Jekyll::MarkdownBlock)

Em seguida, você pode envolver qualquer coisa, incluindo um arquivo .md incluído, neste bloco para que seja processado como marcação, mesmo dentro do HTML.

{% markdown %}
[Stack Overflow](http://www.stackoverflow.com)
{% endmarkdown %}

Crédito para MisterMetaphor por isso.

Este plugin utiliza o analisador de markdown Ruby kramdown .