Skip to main content

Organizando informações com seções recolhidas

Você pode simplificar o Markdown criando uma seção recolhida com a tag <details>.

Quem pode usar esse recurso?

O Markdown pode ser usado na interface Web do GitHub.

Criando uma seção recolhida

Você pode obscurecer temporariamente seções do seu Markdown criando uma seção expandida que o leitor pode optar por expandir. Por exemplo, quando você deseja incluir detalhes técnicos em um comentário do problema que pode não ser relevante ou interessante para todos os leitores, você pode colocar esses detalhes em uma seção recolhida.

Qualquer Markdown dentro do bloco <details> estará recolhido até que o leitor clique em para expandir os detalhes.

No bloco <details>, use a marca <summary> para que os leitores saibam o que está dentro dele. O rótulo aparece à direita de .

<details>

<summary>Tips for collapsed sections</summary>

### You can add a header

You can add text within a collapsed section. 

You can add an image or a code block, too.

```ruby
   puts "Hello World"
```

</details>

O Markdown no rótulo <summary> será recolhido por padrão:

Captura de tela do Markdown na parte superior desta página, conforme renderizado no GitHub, mostrando uma seta para a direita e o cabeçalho "Dicas para seções recolhidas".

Depois que um leitor clica em , os detalhes são expandidos:

Captura de tela do Markdown na parte superior desta página, conforme renderizado no GitHub, indicando que uma seção recolhida pode conter cabeçalhos, frases, imagens e blocos de código.

Opcionalmente, para que a seção seja exibida como aberta por padrão, adicione o atributo open à tag <details>:

<details open>

Leitura adicional