Jekyll
Jekyll é um gerador de sites estáticos que usa como base arquivos com a formatação Markdown.
Visão geral
Conhece o Ruby? Então, essa foi a linguagem de programação escolhida para desenvolver o Jekyll.
O programa é gratuito e de código aberto.
Dentre milhares de sites que usam o Jekyll para converterem arquivos Markdown em HTML, um deles merece destaque, o GitHub Pages.
O GitHub Pages usa o Jekyll como ferramenta principal para converter arquivos Markdown em HTML em seu serviço de hospedagem de sites grátis.
O processador Markdown usado pelo aplicativo é o kramdown.
O Jekyll carrega o kramdown com as configurações padrões, mas você pode alterá-las como mostrado no exemplo abaixo.
kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3O arquivo de configuração é chamado _config.yml, você pode clicar aqui para saber mais sobre as configurações do Jekyll.
Site oficial: https://jekyllrb.com/
Suporte ao Markdown no Jekyll
A Tabela 1.1 apresenta os elementos Markdown compatíveis com o Jekyll.
| Elemento | Suporte | Informação |
|---|---|---|
| Títulos | Sim | |
| Parágrafos | Sim | |
| Quebras de linha | Sim | |
| Negrito | Sim | |
| Itálico | Sim | |
| Blockquote | 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 | Insira a opção syntax_highlighter: rouge na seção kramdown do arquivo _config.yml para habilitar o realce da linguagem dentro do bloco. |
| Notas de rodapé | Sim | |
| Id de títulos | Sim | |
| Listas de definições | Sim | |
| Tachado | Sim | Para riscar uma palavra no Jekyll use dos tiles ~~palavra~~ ou apenas um tile ~palavra~ ao redor do conteúdo. Ambas sintaxes funcionam. |
| Listas de tarefas | Sim | |
| Emoji (copiar e colar) | Sim | |
| Emoji (códigos de acesso) | Não | O Jekyll não fornece suporte por padrão, mas você pode adicionar o plugin jemoji. |
| Link automático de URL | Sim | |
| Desativar o link automático de URL | Sim | |
| HTML | Sim |
Suporte para elementos de sintaxe adicionais
Na Tabela 1.2 você confere elemento mais obscuros suportados pelo Jekyll.
| Elemento | Markdown | Saída |
|---|---|---|
| Abreviação | *[HTML]: Hyper Text Markup LanguageA especificação do HTML é mantida pelo W3C. |
A especificação do HTML é mantida pelo W3C |