menu

Jekyll

O Jekyll é um gerador de site estático que pega os arquivos do Markdown e os converte em um site.

Visão geral

O Jekyll é um aplicativo gratuito e de código aberto escrito na linguagem de programação Ruby. Milhares de sites, confiam no Jekyll para converter arquivos de origem Markdown em saída HTML. O GitHub Pages usa o Jekyll como back-end para seu serviço gratuito de criação de sites.

O Jekyll usa o processador de Markdown kramdown com as configurações padrão, mas você pode alterá-las a qualquer momento, basta editar o arquivo _config.yml. Veja um exemplo abaixo:

kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3

Para saber mais sobre as opções de configuração do Jekyll clique aqui

Site: https://jekyllrb.com/

Suporte do Markdown no Jekyll

O Jekyll fornece suporte para os seguintes elementos Markdown.

Elemento Suporte Obs
Títulos Sim
Parágrafos Sim
Quebras de linha Sim
Negrito Sim
Itálico Sim
Bloco de citação Sim
Listas ordenadas Sim
Listas não ordenadas Sim
Código Sim
Linhas horizontais Sim
Links Sim
Imagens Sim
Tabelas Sim
Blocos de código cercado Sim O realce da sintaxe também é suportado. Certifique-se de que a opção syntax_highlighter: rouge esteja na seção kramdown do arquivo _config.yml
Notas de rodapé Sim
Id de títulos Sim
Listas de definições Sim
Riscado Sim Você pode usar dois tiles (~~palavra~~) ou um til (~palavra~) - ambos funcionam.
Listas de tarefas Sim
Emoji (copiar e colar) Sim
Emoji (códigos de acesso) Não Não é suportado por padrão, mas você pode usar o plugin jemoji para ativar o suporte.
Link automático de URL Sim
Desativar o link automático de URL Sim
HTML Sim

Suporte para elementos de sintaxe adicionais

O Jekyll também é compatível com alguns elementos obscuros.

Elemento Markdown Saída renderizada
Abreviação *[HTML]: Hyper Text Markup Language
A especificação do HTML é mantida pelo W3C.
A especificação do HTML é mantida pelo W3C

Veja também

Opções de configuração do Markdown no Jekyll

Documentação do kramdown