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

Você pode escolher um processador markdown para determinar como o markdown é renderizado no site do GitHub Pages.

Quem pode usar esse recurso?

O GitHub Pages está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud e o GitHub Enterprise Server.

O

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 dá suporte a dois processadores Markdown: o kramdown e o próprio processador Markdown do GitHub, que é usado para renderizar o GFM (GitHub Flavored Markdown) no GitHub Enterprise Server. Para saber mais, confira Sobre gravação e formatação no GitHub.

Você pode usar o GitHub Flavored Markdown com qualquer processador.

  1. Em GitHub Enterprise Server, acesse o repositório do seu site.
  2. No repositório, procure o arquivo _config.yml.
  3. No canto superior direito da exibição de arquivo, clique em para abrir o editor de arquivos.

Captura de tela de um arquivo. No cabeçalho, um botão, rotulado com um ícone de lápis, está contornado em laranja escuro.

  1. Localize a linha que começa com markdown: e altere o valor para kramdown ou GFM. A linha completa deve ser markdown: kramdown ou markdown: GFM.

  2. Clique em Fazer commit das alterações...

  3. No campo "Mensagem do commit", digite uma mensagem curta e relevante que descreva a alteração que você fez no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Criar um commit com vários autores".

  4. 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, confira "Como criar uma solicitação de pull".

    Captura de tela de uma solicitação de pull GitHub mostrando um botão de opção para confirmar diretamente no branch principal ou para criar um branch. O novo branch está selecionado.

  5. Clique em Fazer commit de alterações ou em Propor alterações.

Leitura adicional