Elementos de conteúdo: os blocos com os quais toda página é construída
Use uma biblioteca governada de blocos de definições, respostas, etapas, comparações, evidências, avisos, navegação e conversão para que cada seção mantenha sua função entre autores, páginas, máquinas e CMSes.
Um elemento é um contrato de conteúdo
Um bloco nomeado, tipado e parametrizado define o que pertence a ele, quanto pode conter, onde pode aparecer e o que os sistemas podem fazer com ele.
- ✓Nomeado por propósito — definição, aviso, comparação, fonte e CTA descrevem funções em vez de estilos visuais.
- ✓Delimitado por parâmetros — rótulos, itens, citações, variantes e limites impedem que estruturas improvisadas se desviem.
- ✓Posicionado por regra — uma resposta de abertura, aviso no fluxo, bloco de fontes no final e CTA de próximo passo ocupam diferentes partes de um documento.
- ✓Renderizado por canal — um elemento pode se tornar HTML semântico no Hugo, um bloco nativo do WordPress, dados estruturados ou um registro de feed.
O que é um elemento de conteúdo
Texto livre armazena frases. Um elemento de conteúdo armazena frases mais um registro explícito do que essas frases fazem.
Um autor adiciona um H2 chamado “O que é churn?”, seguido de um parágrafo, e pode aplicar negrito à primeira frase. Um leitor pode inferir que é uma definição. O sistema de conteúdo vê apenas um título e prosa.
Nada registra se a definição é canônica, se deve estar perto da abertura, qual termo define, quanto tempo pode ter ou se outro canal pode reutilizá-la.
O autor insere um elemento definition com um term, um body conciso e um qualificador opcional. O contrato do elemento controla posicionamento, marcação acessível, tamanho e apresentação.
Um template pode renderizá-lo, uma auditoria pode encontrá-lo, uma migração pode mapeá-lo e um sistema de resposta pode distinguir a definição da explicação ao redor.
Um elemento é um bloco de conteúdo nomeado, tipado e parametrizado. “Nomeado” dá a ele uma identidade estável. “Tipado” o conecta a um comportamento. “Parametrizado” significa que suas partes significativas são campos em vez de uma massa amorfa. Ele também carrega regras de posição, limites de conteúdo, variantes, requisitos de acessibilidade, mapeamentos de esquema e verificações de QA.
Isso não elimina a prosa. Uma definição, aviso ou nota de fonte ainda precisa de redação precisa. Elimina a ambiguidade sobre a função da prosa. A linguagem pode variar enquanto honra o contrato, assim como registros diferentes contêm dados diferentes enquanto compartilham um esquema.
Por que elementos superam briefings de conteúdo
Um briefing de prosa pode descrever a página desejada. Elementos tipados preservam suas decisões importantes depois que o briefing sai da tela do editor.
O objetivo não é que toda página pareça idêntica. É que funções repetidas se comportem de forma previsível. Um estudo de caso e uma página de glossário podem ter vozes e layouts diferentes enquanto suas fontes permanecem consultáveis e seus blocos de conteúdo relacionado permanecem governados.
A regra de precedência de elementos
Se o propósito de um elemento corresponde ao que a seção faz, esse elemento é obrigatório — mesmo que um título e parágrafo pudessem exibir as mesmas palavras. Texto livre é a alternativa, não o padrão.
Não procure apenas pelo rótulo no esboço. “Considerações clínicas” pode esconder um aviso. “De relance” pode significar principais conclusões. Nomeie a tarefa do leitor: definir, resumir, avisar, comparar, instruir, provar, navegar ou converter.
Depois verifique as declarações de propósito. Um propósito correspondente tem precedência sobre um título personalizado porque o tipo preserva a função fora da página visível.
Texto livre é adequado para análises, transições, exemplos e explicações sem contrato reutilizável. Deve conectar elementos e desenvolver o argumento, não personificar um componente existente.
Se um padrão de texto livre se repetir, registre-o para revisão da biblioteca. A repetição pode revelar um elemento faltante, mas autores não devem criar componentes não oficiais página por página.
| Redação do esboço | Propósito | Escolha obrigatória | O que a prosa perde |
|---|---|---|---|
| “O que é X?” | Dar um significado delimitado | caixa de definição | A definição não pode ser separada confiavelmente do contexto. |
| “Quando procurar ajuda” ou “contraindicações” | Declarar risco, consequência e ação segura | caixa de aviso | Uma condição de parada não tem semântica de aviso. |
| Um aparte prático | Oferecer conselho opcional de execução | caixa de dica | O aparte compete com ou desaparece dentro de etapas obrigatórias. |
| O resumo no topo | Destacar conclusões fundamentadas | principais conclusões | Uma lista solta não tem posicionamento, limite ou significado de resumo. |
| Uma lista para marcar | Rastrear estados de conclusão | Elemento de checklist | Marcadores não distinguem ações de observações ou status. |
O exemplo de checklist não está linkado porque sua especificação detalhada pertence a uma onda posterior da biblioteca. A decisão de precedência ainda se aplica: use uma implementação de checklist aprovada onde o CMS a fornecer; não disfarce estados de conclusão como marcadores decorativos.
Blocos tipados vs texto simples
A frase visível é idêntica. A versão tipada retém identidade e campos que sistemas downstream podem usar sem adivinhar.
Churn de clientes é a perda de clientes ou assinantes durante um período medido.
Armazenado como
{ "heading": "O que é churn de clientes?",
"html": "<p>Churn de clientes é…</p>" }Saída da máquina: título e HTML genérico. Status de definição, termo, posicionamento e reutilização são desconhecidos.
Churn de clientes é a perda de clientes ou assinantes durante um período medido.
Armazenado como
{ "type": "definition",
"term": "churn de clientes",
"body": "Churn de clientes é…",
"position": "opening" }Saída da máquina: uma definição conhecida com campos endereçáveis, validação, renderização semântica, mapeamento de esquema e elegibilidade para feed.
A diferença é funcional, não cosmética. Substitua o componente por um título e parágrafo e o leitor pode não notar nada, enquanto o sistema perde validação, análises, mapeamento de esquema, lógica de migração e consultas de portfólio. Trocar um elemento tipado por texto livre é uma perda de função.
Os onze grupos de elementos
Cada cartão ativo espelha os metadados playbookFamily das páginas filhas. As contagens descrevem a biblioteca de elementos publicada; grupos adicionais estão planejados para ondas posteriores.
Leia primeiro — a regra de precedência que governa todo outro elemento.
O registro que conduz identidade, descoberta e esquema.
A primeira tela: resposta, resumo, definição, orientação.
Caixa de Definição · Bloco de Resposta Direta · Selo de Atualização · Gancho de Introdução · Caixa de Principais Conclusões · Sumário · Para Quem É Isso? Regras de Bloco de Público
Os blocos que carregam o argumento.
Acordeão · Listas com Marcadores · Checklist · Listagens Personalizadas · Árvore de Decisão · O que Fazer e Não Fazer · Regras de Parágrafo de Texto Livre · Sistema de Títulos · Caixa de Ícone · Caixa de Imagem · Infobox · Infobox · Listas de Etapas · Abas / Alternador de Persona · Linhas do Tempo · Seções Ziguezague
Fatos estruturados que um leitor e uma máquina podem usar.
Incorporação de Calculadora · Blocos de Gráfico · Tabelas Comparativas · Tabelas de Preço · Blocos de Prós e Contras · Cartões de Pontuação · Tabelas de Especificações · Faixas de Estatísticas
Dicas, notas e avisos — usados com moderação ou nem isso.
Caixa de Nota · Notificação · Caixa de Dica · Caixa de Aviso
Imagens, vídeos, diagramas e seus equivalentes em texto.
Capturas de Tela Anotadas · Incorporação de Áudio e Podcast · Diagramas e Ilustrações · Galeria de Imagens · Imagens Inline · Vídeo Inline · Incorporação de Vídeo
Produto, preço, disponibilidade e composição.
Blocos de Disponibilidade · Blocos de Composição · Caixas de Oferta · Cartões de Produto · Sliders de Produto
Autoria, revisão, citação e prova social.
Bloco de Biografia do Autor · Bloco de Aviso Legal · Citação em Destaque e Citação de Especialista · Bloco Revisado por · Blocos de Avaliações · Fontes e Referências · Depoimentos · Selos de Confiança e Certificações · Registro de Atualizações
Links, âncoras e a próxima ação.
Links de Âncora · Migalhas de Pão · Blocos de CTA · Links de Termos de Glossário e Tooltips · Botão CTA Inline · Módulos de Link Interno · Mini Banner · Captura de Newsletter · Blocos de Conteúdo Relacionado
Horários, endereço, mapa e reservas.
Blocos de Reserva · Blocos de Horários e Contato · Blocos de Mapa · Blocos NAP
Como uma página termina e o que ela pergunta em seguida.
Um elemento, três formatos
Cada elemento tem um contrato conceitual e adaptadores para Markdown portátil, Hugo e WordPress.
Considere uma dica com um título e corpo de conselho opcional. Seu propósito, conteúdo permitido, função de acessibilidade, posição e regras de QA permanecem constantes. Apenas a notação muda.
:::tip{title="Mantenha a consulta estável"}
Altere uma variável de cada vez.
:::Legível na fonte e independente do tema do site.
{{< callout type="tip" title="Mantenha a consulta estável" >}}
Altere uma variável de cada vez.
{{< /callout >}}O adaptador mapeia campos nomeados para o componente aprovado.
<!-- wp:amicited/tip
{"title":"Mantenha a consulta estável"} -->
<p>Altere uma variável de cada vez.</p>
<!-- /wp:amicited/tip -->Controles nativos do editor preservam o mesmo tipo e campos.
Portabilidade não é copiar HTML renderizado. Cada adaptador aceita a mesma entrada significativa, aplica restrições equivalentes e produz saída adequada ao canal. Se um campo não puder ser mapeado com segurança, o adaptador deve falhar visivelmente ou documentar uma alternativa controlada; não deve descartar significado silenciosamente.
O que está em cada página de elemento
Cada página de detalhes é uma orientação pública e uma especificação de produção. Ela elimina suposições que de outra forma retornam em cada implementação.
| Área | Pergunta respondida | Falha prevenida |
|---|---|---|
| Propósito e não propósito | Qual função ele desempenha, e qual função similar pertence a outro lugar? | Uma dica carregando uma etapa obrigatória ou uma definição se tornando um miniartigo. |
| Tabela de parâmetros | Quais campos são obrigatórios, opcionais, tipados, repetíveis e limitados? | Adaptadores aceitando dados diferentes ou várias ideias escondidas em um campo. |
| Regras de posição | Onde pode aparecer, com que frequência e ao lado do quê? | Conclusões enterradas no meio da página ou fontes desconectadas de afirmações. |
| Galeria de variantes | Quais variações nomeadas existem e quando cada uma é apropriada? | Soluções visuais únicas se passando por variantes oficiais. |
| Bom versus ruim | O que um exemplo em conformidade faz que uma falha plausível perde? | Equipes copiando sintaxe enquanto perdem o propósito. |
| Mapeamento de esquema | Como os campos mapeiam para HTML, acessibilidade, esquema, APIs e feeds? | Conteúdo visível discordando da saída da máquina. |
| QA | O que a automação pode aplicar e o que precisa de julgamento? | Um bloco válido sendo publicado com conteúdo vago, falso, desatualizado ou mal posicionado. |
A automação pode verificar campos obrigatórios, contagens, tamanhos, posicionamento, identificadores, URLs e suporte do adaptador. O QA editorial deve verificar precisão, utilidade, qualidade da evidência, ênfase proporcional e se o elemento é adequado para a tarefa do leitor.
Quais elementos são obrigatórios
Obrigatório significa que o sistema espera a função em essencialmente todo tipo de postagem completa. Não significa que todo bloco deve ser grande ou idêntico.
- Frontmatter estabelece identidade, propriedade, descoberta e conexões.
- Introdução confirma escopo e adequação ao leitor.
- Principais conclusões destacam conclusões fundamentadas em páginas substanciais.
- FAQ resolve perguntas residuais genuínas.
- Fontes tornam o suporte factual rastreável.
- Conteúdo relacionado fornece a próxima rota de aprendizado.
- CTA oferece uma ação proporcional.
- Use uma definição quando um termo precisar de um significado delimitado.
- Use uma resposta direta para uma pergunta principal clara.
- Use etapas para um procedimento ordenado e resultado verificável.
- Use comparações quando leitores avaliam alternativas com critérios consistentes.
- Use uma dica para melhoria opcional e um aviso para risco material.
- Use mídia anotada quando o visual comunica algo que a prosa não consegue com a mesma eficiência.
Exceções importam. Uma definição curta de glossário pode não precisar de conclusões separadas. Uma página sem nenhuma afirmação factual com suporte externo pode não precisar de referências visíveis. Um FAQ com perguntas inventadas é pior que nenhum. Especificações de tipos de postagem definem padrões; autores documentam omissões justificadas em vez de preencher slots mecanicamente.
Comece com a especificação de tipos de postagem relevante, que ordena os elementos habituais para a tarefa do leitor. Depois aplique a precedência seção por seção. O resultado não é uma página em branco nem um formulário rígido: é uma montagem governada com espaço para argumento original, evidência, exemplos e voz.
Elementos tipados permitem que um agente monte em vez de inventar
A biblioteca de elementos é onde um sistema de conteúdo deixa de ser um documento e se torna algo que uma máquina pode executar. Um bloco com campos declarados ou tem o que precisa ou visivelmente não tem.
Uma tabela comparativa precisa de opções comparáveis, uma dimensão declarada por linha e uma data de verificação. Quando um desses insumos não existe, um bloco tipado dá ao agente um lugar para falhar ruidosamente.
Prosa livre não tem essa propriedade. Solicitado a fazer uma tabela sem dados por trás, um agente produz uma tabela mesmo assim, e a célula inventada parece exatamente igual a uma pesquisada.
Verifique a biblioteca por propósito antes de escrever um título. Essa instrução é seguida de forma muito mais confiável por um agente do que por uma pessoa sob prazo, porque um agente realmente relerá a biblioteca inteira toda vez.
Este é um caso onde o agente é o melhor operador: a regra é mecânica, e mecânico é para o que agentes servem.
Cada elemento é definido uma vez e expresso como uma diretiva Markdown portátil, um shortcode Hugo e um bloco WordPress. O agente trabalha com a forma portátil e nunca precisa saber em qual CMS a saída será publicada.
Isso também significa que mudar de CMS não invalida o sistema de conteúdo nem requer reensinar o agente.
Como os elementos são tipados, o corpus pode ser consultado. Quais páginas não têm um bloco de fontes. Quais tabelas comparativas não têm data de verificação. Quais respostas diretas excedem sua faixa.
Você só pode executar essa auditoria em conteúdo montado a partir de blocos nomeados. Prosa não é consultável, então o controle de qualidade baseado em prosa não escala além do número de páginas que uma pessoa consegue ler.
Cada página de elemento carrega uma tabela de parâmetros com campos obrigatórios, mínimos e máximos, regras de posição e uma lista de verificação de QA. Esse é o nível de precisão que um agente precisa para construir sem adivinhar — e a mesma precisão torna a saída revisável por um humano em uma fração do tempo.
Elementos de conteúdo FAQ
Um elemento de conteúdo é um bloco nomeado, tipado e parametrizado com um propósito definido, campos permitidos, regras de posição, limites de tamanho, comportamento de renderização e verificações de qualidade. Ele armazena conteúdo e função.
Use texto livre quando nenhum elemento da biblioteca corresponder ao propósito. Análise, narrativa, transições e explicações únicas geralmente permanecem como prosa; definições estabelecidas, avisos, comparações, fontes e CTAs não.
Não. O contrato padroniza estrutura e função, não conclusões ou voz. Autores ainda escolhem argumentos, evidências, exemplos e redação.
Sim. O contrato portável é independente da apresentação. Adaptadores mapeiam os mesmos campos para sintaxe e marcação nativas, preservando validação e semântica.
Construa uma página a partir de blocos que você pode governar em escala
Verificação gratuita · Teste de 7 dias · cartão de crédito necessário