Definir um processador markdown para seu site do GitHub Pages usando o Jekyll

Pessoas com permissões de gravação para um repositório podem definir um processador markdown para um site do GitHub Pages.

O GitHub Pages é compatível com dois processadores markdown: kramdown e o próprio processador CommonMark estendido do GitHub, que é usado para renderizar markdown em estilo GitHub em todo o GitHub Enterprise. Para obter mais informações, consulte "Sobre gravação e formatação no GitHub".

Você pode usar o markdown em estilo GitHub com qualquer um dos processadores, mas apenas o processador CommonMark é que sempre corresponderá aos resultados que você vê no GitHub Enterprise.

1. On GitHub Enterprise, navigate to your site's repository.

2. No repositório, navegue até o arquivo _config.yml.

3. No canto superior direito da exibição do arquivo, clique em para abrir o editor de arquivos.

   

4. Localize a linha que começa com markdown: e altere o valor para kramdown ou GFM.

   

5. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, consulte "Criar um commit com vários co-autores."

   

6. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. Para obter mais informações, consulte "Criar uma nova pull request."

   

7. Clique em Propose new file.

   

Further reading

• Documentação do kramdown
• Especificações de markdown em estilo GitHub