Caixa de Definição: Formato, Regras e Exemplos

Uma caixa de definição fornece ao termo principal da página uma explicação exata e delimitada antes que o artigo o desenvolva. É um elemento de abertura: um componente de conteúdo reutilizável que aparece próximo ao início porque o leitor não deve precisar inferir o termo central a partir de exemplos, benefícios ou contexto.

Esse exemplo ao vivo é o elemento completo, não uma prévia de uma definição mais adiante na página. Seu título é opcional; seu corpo não é. O contrato de produção abaixo determina quando o elemento pertence, o que cada campo significa e como o mesmo conteúdo é mapeado entre sistemas de publicação.

Por que este elemento é importante

Leitores raramente começam uma página informativa lendo cada palavra em ordem. Eles examinam o título, as linhas iniciais, os cabeçalhos e os blocos visualmente distintos para decidir se a página responde à sua pergunta. Uma definição enterrada em um parágrafo introdutório faz com que esse leitor separe a resposta do contexto, alegações e ambientação. A caixa elimina esse trabalho: seu limite diz “esta é a definição.”

Esse limite também dá à definição uma posição estável e endereçável. Editores sabem onde revisá-la, modelos sabem onde renderizá-la, e revisões futuras não forçam um leitor ou uma verificação de qualidade a vasculhar vários parágrafos de abertura. O posicionamento consistente é importante em uma biblioteca porque a mesma função informacional não deve se mover imprevisivelmente de página para página.

A extraibilidade por máquina é a capacidade de o software isolar uma unidade de conteúdo sem perder seu significado. Uma definição tipificada com título e corpo pode ser indexada, comparada, citada ou transformada de forma independente. Uma frase que meramente define um termo dentro de texto livre dissolve-se na prosa circundante: o software precisa adivinhar onde a definição começa, onde termina e se a afirmação anterior faz parte dela. Siga as regras de escrita de elementos para que a identidade semântica sobreviva mesmo quando o design visual mudar.

O texto ainda precisa funcionar sem a caixa. A estilização cria contraste para pessoas; um sujeito, verbo e significado distintivo autossuficientes criam extraibilidade para máquinas. “É um método para melhorá-los” falha quando removido de seu parágrafo. “Poda de conteúdo é o processo de remover, consolidar ou atualizar páginas que não servem mais a um propósito útil de busca ou negócio” sobrevive.

Quando usar

Use uma caixa de definição quando a página estiver organizada em torno de um termo e esse termo puder ser definido precisamente em uma declaração curta. É obrigatória para formatos de termo de glossário e o-que-é-X. Também é obrigatória para conteúdo do tipo diagnóstico ou condição: o leitor precisa saber o que é a condição nomeada antes de considerar causas, exames ou remédios.

Páginas focadas em sintomas e guias de como fazer usam o elemento raramente. Adicione-o apenas quando uma definição curta resolver uma ambiguidade genuína necessária para a tarefa. Por exemplo, um guia intitulado “Como corrigir canibalização de palavras-chave” pode definir canibalização de palavras-chave antes das etapas porque o diagnóstico controla qual correção se aplica. Um guia intitulado “Como alterar uma tag de título” não precisa de uma caixa definindo tag de título se o público e a instrução inicial já tornarem o objeto inequívoco.

Não use uma caixa de definição para:

• Uma introdução ampla, histórico, alegação de benefício ou explicação de por que o assunto é importante. Essas passagens desenvolvem o artigo; elas não definem o termo.
• Um resumo da página. Um resumo reúne várias conclusões, enquanto uma definição declara o significado de um termo.
• Uma promessa de produto como “AmICited é a maneira mais fácil de melhorar a visibilidade.” Isso é posicionamento, não uma definição testável.
• Um aviso, ressalva, pré-requisito ou dica. Sua função comunicativa é diferente, mesmo quando um tema pode fazê-lo parecer o mesmo painel colorido.
• Um termo secundário introduzido no meio do artigo. Defina esse termo na frase onde ele aparece pela primeira vez, ou dê a ele sua própria página quando merecer tratamento prolongado.
• Uma citação cuja autoridade substitui a clareza. Atribua uma definição formal na prosa circundante quando a atribuição for necessária; mantenha a caixa legível como uma declaração direta.

O erro comum é uma “introdução à definição”: “A rotatividade de clientes é um dos conceitos mais importantes para negócios de assinatura, e entendê-la pode transformar o crescimento.” Isso diz que o conceito é importante, mas nunca diz o que ele é. A caixa não pode tornar precisa uma ambientação vazia.

Onde posicionar

O posicionamento codifica a prioridade. Coloque a caixa de definição imediatamente após o parágrafo introdutório ou introdução curta, como o primeiro bloco de conteúdo. A introdução estabelece por que o leitor está na página; a caixa então fixa o significado antes que quaisquer causas, exemplos, benefícios, etapas ou comparações dependam dele.

Não coloque navegação, sumário, principais conclusões, galeria de imagens ou chamada para ação promocional entre a introdução e a definição. Esses blocos forçam o leitor a atravessar material não relacionado antes de receber o significado do termo. Breadcrumbs e o hero da página são elementos de template em vez de conteúdo autoral, portanto podem preceder a introdução.

Use uma caixa de definição por página. A regra existe porque o componente identifica o objeto definicional principal da página. Duas caixas criam dois termos principais concorrentes e tornam a extração ambígua. Se ambos os termos são genuinamente principais, divida o assunto em duas páginas e conecte-os em prosa. Se o segundo termo é subordinado, defina-o em linha em vez de estilizá-lo como uma segunda resposta canônica.

Um bloco de resposta direta pode coexistir com uma definição apenas quando responde a uma pergunta principal diferente. Em uma página de diagnóstico, a definição pode declarar o que é a condição enquanto a resposta direta declara a primeira ação recomendada. Quando a pergunta principal da página é “O que é X?”, a resposta direta e a definição são a mesma resposta. Combine-os em uma caixa de definição; versões adjacentes meramente repetem o texto e competem por extração.

Anatomia

O elemento tem duas regiões autorais e uma relação estrutural. A captura de tela deve mostrar o elemento renderizado sem incorporar texto explicativo na imagem; a legenda abaixo permanece selecionável, acessível e mantenível quando o design mudar.

Legenda renderizada

1. Título opcional: Geralmente “O que é X?” Identifica o termo exato e não deve adicionar uma segunda afirmação.
2. Corpo obrigatório: Uma definição autossuficiente que nomeia o termo, o coloca em uma categoria útil e declara o que o distingue.
3. Posição de abertura: A caixa segue a introdução e precede a primeira seção explicativa. Esta relação faz parte do contrato mesmo não sendo um campo.

Borda, fundo, preenchimento, tratamento de ícone e tipografia pertencem ao renderizador. Autores fornecem significado, não tokens visuais. O elemento deve permanecer compreensível se todo estilo decorativo for removido.

Exemplos de design

A galeria cobre as variantes de conteúdo suportadas, em vez de inventar diferentes tipos semânticos. Cada captura deve reutilizar a mesma definição quando possível para que revisores possam julgar o tratamento do título, quebra de corpo e comportamento no viewport em vez de comparar textos não relacionados.

Com título: A variante preferida quando o termo é desconhecido, ambíguo, abreviado ou diferente do título exato da página.

Sem título: Permitida quando o cabeçalho da página e a introdução imediatamente anterior tornam o assunto inequívoco. O corpo ainda deve nomear o termo; a omissão do título nunca permite que pronomes como “ele” substituam o sujeito.

Comprimento máximo: O renderizador quebra o corpo completo. Não deve truncar, colapsar, rolar ou reduzir a fonte para acomodar texto no máximo editorial.

Viewport estreito: Título e corpo mantêm sua ordem, comprimento de linha legível e limite visível. Nenhum significado pode depender de um ícone se movendo ao lado do texto.

Parâmetros

Os parâmetros separam conteúdo de apresentação. Seus limites mantêm as definições comparáveis entre páginas e impedem que o componente se transforme em um callout de uso geral.

Parâmetros da caixa de definição

O renderizador pode derivar o termo para indexação, mas os autores nunca devem escrever um corpo que dependa desse campo derivado ser exibido. Uma definição copiada precisa nomear seu sujeito explicitamente.

Sintaxe e exemplos de código

Todas as três formas carregam o mesmo título e corpo. A diretiva Markdown portátil é a forma autoral canônica; Hugo e WordPress são adaptadores. Os exemplos usam deliberadamente a mesma redação para que um teste de migração possa comparar valores, não apenas aparência.

Diretiva Markdown portátil

:::definition
## O que é poda de conteúdo?

Poda de conteúdo é o processo de remover, consolidar ou atualizar páginas que não servem mais a um propósito útil de busca ou negócio.
:::

O primeiro cabeçalho mapeia para title; tudo depois dele mapeia para body. Omita o cabeçalho para a variante sem título, mas mantenha o termo no corpo.

Shortcode Hugo

{{< callout type="note" title="O que é poda de conteúdo?" >}}Poda de conteúdo é o processo de remover, consolidar ou atualizar páginas que não servem mais a um propósito útil de busca ou negócio.{{< /callout >}}

O site reutiliza o renderizador de callout existente para o tratamento visual Hugo. O contrato de definição ainda vem da fonte portátil tipificada: note é um adaptador de renderização aqui, não permissão para colocar notas comuns em caixas de definição.

Bloco ou shortcode WordPress

[definition title="O que é poda de conteúdo?"]Poda de conteúdo é o processo de remover, consolidar ou atualizar páginas que não servem mais a um propósito útil de busca ou negócio.[/definition]

Uma implementação WordPress pode expor os mesmos campos como um bloco personalizado. Os valores armazenados permanecem title e body; controles do editor, cores e espaçamento são configurações de apresentação e não devem alterar o significado da definição.

Exemplos

Isso é bom porque nomeia o termo, identifica a condição e declara a consequência distintiva. Não afirma que todo par de páginas compartilhando uma palavra compete; a expressão “mesma intenção de busca” fornece o limite necessário. O corpo é útil sem o título e curto o suficiente para ser citado por inteiro.

Isso é ruim porque nunca define canibalização de palavras-chave. Oferece importância, público, urgência e um efeito vago, mas nenhuma categoria ou condição distintiva. Substituir “um dos mais importantes” por “uma situação onde múltiplas páginas competem pela mesma intenção de busca” transforma promoção em significado.

Um segundo padrão ruim é sobrecarregar a caixa: uma definição seguida de causas, cinco exemplos, um aviso e uma ferramenta recomendada. Mesmo que a primeira frase seja precisa, o material extra destrói o limite estável. Mantenha a definição; mova causas e exemplos para a próxima seção, o aviso para seu elemento correto e a recomendação para o ponto onde o leitor pode agir sobre ela.

Marcação Schema e acessibilidade

Uma caixa de definição não cria automaticamente uma entidade Schema.org autônoma. Em um artigo comum, seu texto permanece parte do Article ou TechArticle circundante. Em uma página de glossário, uma implementação de publicação pode mapear o termo e a definição para um vocabulário adequado apenas quando o site tiver adotado essa política de schema. Não invente um tipo DefinitionBox: ele não existe no Schema.org.

Da mesma forma, não duplique o corpo em JSON-LD meramente porque a caixa parece importante. A marcação Schema deve descrever a página com veracidade, e duplicar prosa visível em uma propriedade não relacionada cria ruído em vez de significado mais forte. Se uma propriedade de schema for preenchida, seu valor deve corresponder à definição visível em substância e ser atualizado com ela.

O elemento não precisa de um papel ARIA interativo. Renderize-o na ordem documental normal como uma região rotulada ou contêiner semântico, com o título antes do corpo. Não use role="alert", porque uma definição estática não é informação urgente ou recém-chegada. Não use cor ou ícone como único sinal de que o bloco é uma definição. Se o título for implementado como cabeçalho, seu nível deve seguir a hierarquia da página; o ## da fonte é uma convenção de mapeamento de campo, não uma instrução para criar um salto de cabeçalho inválido.

O comportamento de teclado é o comportamento de leitura comum: a caixa em si não é focalizável. Qualquer link interno segue a semântica normal de links e precisa de uma âncora descritiva. A saída do leitor de tela deve preservar a mesma ordem título-depois-corpo visível na tela.

Regras de escrita

Escreva a definição antes de escrever seus benefícios. Comece com o termo em si, depois use um verbo de ligação como “é”, “significa” ou “ocorre quando”. Declare a categoria útil mais próxima e a característica que separa o termo de conceitos vizinhos. Essa sequência existe porque categoria sem distinção é ampla, enquanto distinção sem categoria deixa o leitor incerto sobre que tipo de coisa o termo é.

Mantenha o corpo em cerca de 300 caracteres no máximo, incluindo espaços. Prefira uma frase. Uma segunda frase curta é aceitável apenas quando um limite necessário não puder ser expresso claramente na primeira. O limite é editorial, não um convite para comprimir pontuação, remover artigos ou empilhar orações. Se a precisão exigir mais espaço, coloque o núcleo exato na caixa e qualifique-o imediatamente depois.

Use um tom neutro e declarativo. Evite “importante”, “poderoso”, “revolucionário”, “você precisa saber” e julgamentos semelhantes. Evite definições circulares como “otimização de conteúdo é o ato de otimizar conteúdo.” Expanda abreviações no primeiro uso, a menos que a própria abreviação seja o termo da página. Use o mesmo nome canônico que aparece no título da página.

Nunca coloque estes itens dentro do corpo:

• Mais de um termo principal ou uma lista de termos relacionados.
• Benefícios, histórico, causas, sintomas, exemplos, etapas, pitches de produto ou chamadas para ação.
• Tabelas, imagens, vídeos, formulários, botões, notas de rodapé ou callouts aninhados.
• Superlativos sem suporte, estatísticas inventadas ou afirmações que exijam um parágrafo de evidência.
• Um segundo cabeçalho, lista com marcadores ou citação em bloco.
• Pronomes cujo significado dependa da introdução anterior.

Um link de atribuição é a exceção, não o objetivo. Use-o apenas quando uma definição legal, científica ou baseada em padrões depender de uma fonte nomeada. Coloque citações extensas e discordância entre fontes em prosa comum, onde o leitor possa ver a qualificação em vez de confundir uma redação contestada com uma definição universal.

Tipos de postagem que o utilizam

O frontmatter postTypes registra as associações registradas. A tabela traduz essas associações em regras editoriais. Formatos do tipo diagnóstico/condição e focados em sintomas são descritos aqui como padrões de uso, mas não estão vinculados como tipos de postagem separados do playbook porque não estão no registro canônico atual.

Requisitos por tipo de postagem

Para páginas do tipo diagnóstico ou condição, use a caixa sempre e coloque-a antes de sintomas, causas, gravidade ou remédios. Para páginas focadas em sintomas, use-a apenas quando o nome do sintoma tiver uma definição genuinamente curta e estável. Se a caixa meramente reafirmar o título — “Um site lento é um site que é lento” — omita-a e comece com o limiar diagnóstico ou problema observável em prosa.

Checklist de controle de qualidade

Um revisor verifica o significado antes da aparência. Uma caixa polida contendo uma introdução vaga ainda é uma definição falha.

• Um termo principal: A página e a caixa definem exatamente um conceito principal.
• Posição correta: A caixa é o primeiro bloco de conteúdo autoral após a introdução, sem sumário, principais conclusões, galeria ou promoção inseridos antes dela.
• Uma ocorrência: Nenhuma segunda caixa de definição compete com a resposta canônica.
• Definição real: O corpo declara o que o termo é ou quando a condição existe; não diz meramente por que o termo é importante.
• Redação autossuficiente: O corpo nomeia seu sujeito e faz sentido quando copiado sem prosa ou estilização adjacente.
• Precisão: Categoria, característica distintiva e qualquer limite essencial são precisos. A redação não generaliza excessivamente.
• Tamanho: O corpo não excede cerca de 300 caracteres e permanece legível em vez de comprimido.
• Conteúdo limpo: Nenhum benefício, histórico, exemplo, etapa, alegação de produto, mídia, tabela ou elemento aninhado aparece no interior.
• Decisão de resposta direta: Se a página pergunta “O que é X?”, a caixa de definição é o único elemento de resposta direta. Se ambos os elementos aparecem, eles respondem a perguntas claramente diferentes.
• Semântica acessível: Título precede corpo, o nível do cabeçalho é válido, a cor não é o único identificador e nenhum papel de alerta ou alvo de foco desnecessário está presente.
• Paridade portátil: Os mapeamentos Markdown, Hugo e WordPress retêm o mesmo título e definição.
• Restrição de dados estruturados: Qualquer valor de schema corresponde ao texto visível, e nenhum tipo Schema.org inventado é usado.
• Status das capturas de tela: Comentários permanecem instruções de captura não renderizadas até que os arquivos nomeados existam; nenhum caminho de imagem inexistente é referenciado como imagem.

FAQ

O template da academia renderiza as cinco perguntas revisadas armazenadas no frontmatter [[faq]] desta página. Juntas, elas cobrem necessidade, coexistência com respostas diretas, links e citações, o limite de tamanho e a regra de uma por página.