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.

GitHub Pages supports two Markdown processors: kramdown and GitHub's own extended CommonMark processor, which is used to render GitHub Flavored Markdown throughout GitHub Enterprise Server. 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 Server.

1. Em GitHub Enterprise Server, acesse o repositório do seu site.

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. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, consulte "Criar uma nova pull request."

   

7. Clique em Propose new file.

   

Leia mais

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