---
title: "Como alterar o texto do nome da linguagem em blocos de código"
slug: "how-to-change-the-language-name-text-in-code-blocks"
description: "You would want to keep a constant name, like Example, Sample code, etc., as language name text for code blocks. By default, the respective language name appears in the code blocks. "
tags: ["Customization"]
updated: 2026-06-22T08:58:57Z
published: 2026-06-22T08:58:57Z
canonical: "docs.document360.com/how-to-change-the-language-name-text-in-code-blocks"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Como alterar o texto do nome da linguagem em blocos de código

Blocos de código no Document360 exibem o nome da linguagem de programação como um rótulo por padrão, por exemplo, `css`, `javascript`, ou `xml`. Para bases de conhecimento que documentam sistemas proprietários, ferramentas internas ou formatos não padronizados, esses rótulos genéricos de linguagem podem ser confusos ou irrelevantes para os leitores. Substituí-los por uma etiqueta personalizada consistente como "Exemplo" ou "Código de exemplo" deixa os blocos de código mais claros e dá à sua documentação uma aparência mais polida e marcada.

---

## Quando usar isso

Use essa personalização quando quiser:

- Substituir os nomes das linguagens técnicas por etiquetas amigáveis para o leitor (por exemplo, "Exemplo de código" em vez de "javascript").
- Aplique um rótulo de bloco de código consistente em toda a sua base de conhecimento para um visual uniforme.
- Documente linguagens de script proprietárias ou formatos de configuração onde o rótulo padrão não corresponde ao seu conteúdo.

> [!NOTE]
> NOTA
> 
> 
> 
> 
> Essa mudança de CSS se aplica **a todos os blocos de código** de toda a sua base de conhecimento — não a artigos individuais ou blocos específicos.

---

## Antes de começar

Você precisa de acesso às **Configurações > site da base de conhecimento > Personalização do site > CSS & JavaScript personalizados** no portal da base de conhecimento.

---

## Como alterar o rótulo da linguagem em blocos de código

1. Navegar até **Configurações** (

) > **site da base de conhecimento** > **personalização do site** > **CSS & JavaScript personalizados** no portal da base de conhecimento.

![Custom CSS and JavaScript settings panel in the Document360 Knowledge base portal](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Custom%20css%20&%20js.png)
2. No painel de navegação à esquerda, selecione a aba **CSS** e cole o seguinte trecho de CSS:

```
div.code-toolbar>.toolbar .toolbar-item:first-child {
    visibility: hidden;
}
div.code-toolbar>.toolbar .toolbar-item:first-child span:before {
    visibility: visible;
    content: "Example" !important;
}
```

1. Substitua `"Example"` pelo texto da etiqueta desejada, por exemplo, `"Sample code"`, `"Command"`, ou pelo nome do seu produto.
2. Clique **em Salvar**.

![CSS tab showing the custom label snippet saved in the Custom CSS and JavaScript panel](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1766998756574.png)

---

## Melhores práticas

- **Escolha um rótulo que reflita seu público.** Leitores que não são desenvolvedores podem achar rótulos como "Exemplo" ou "Comando" mais intuitivos do que "bash" ou "python". Associe o rótulo ao que seus leitores chamam desse tipo de conteúdo.
- **Mantenha o rótulo curto.** Etiquetas de blocos de código têm espaço de exibição limitado. Rótulos acima de 20 caracteres podem ser truncados dependendo do tamanho da tela do leitor.
- **Teste após salvar.** Abra um artigo no seu site de base de conhecimento e confirme que o novo rótulo aparece corretamente em diferentes tipos de blocos de código antes de publicar para os leitores.
- **Considere rótulos por bloco para públicos técnicos.** Se seus leitores são desenvolvedores que precisam ver exatamente a linguagem, use o recurso de etiqueta personalizada embutido do Document360 em blocos de código individuais em vez desse CSS que cobre todo o site. Navegue até o bloco de código no editor, selecione **Personalizado** no menu suspenso do idioma, clique no **ícone Editar** e insira um título apenas para esse bloco.