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.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para obter mais informações, consulte os "produtos do GitHub".

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

GitHub Pages é compatível com dois processadores de Markdown: kramdown e o próprio processador do Markdown de GitHub, que é usado para interpretar o Markdown enriquecido (GMF) de GitHub em GitHub Enterprise Cloud. Para obter mais informações, consulte "Sobre gravação e formatação no GitHub".

Você pode usar o Markdown enriquecido de GitHub com qualquer um dos processadores, mas apenas o nosso processador de GFM sempre corresponderá aos resultados que você vê em GitHub Enterprise Cloud.

  1. Em GitHub Enterprise Cloud, 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. Botão Edit file (Editar arquivo)

  4. Localize a linha que começa com markdown: e altere o valor para kramdown ou GFM. Configuração do markdown em config.yml

  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." Mensagem do commit para sua alteração

  6. If you have more than one email address associated with your account on GitHub.com, click the email address drop-down menu and select the email address to use as the Git author email address. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você ativou a privacidade do endereço de e-mail, então <username>@users.noreply.github.com é o endereço de e-mail do autor de commit padrão. Para obter mais informações, consulte "Setting your commit email address." Escolha um endereço de e-mail commit

  7. 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." Opções para fazer commit no branch

  8. Clique em Propose new file. Propor botão de novo arquivo

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.