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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

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 master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

7. Click Propose new file.

   

Further reading

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