Elementos de contenido: los bloques con los que se construye cada página
Usa una biblioteca regulada de definiciones, respuestas, pasos, comparaciones, evidencia, avisos, navegación y bloques de conversión para que cada sección mantenga su función entre autores, páginas, máquinas y CMS.
Un elemento es un contrato de contenido
Un bloque nombrado, tipificado y parametrizado define qué pertenece dentro de él, cuánto puede contener, dónde puede aparecer y qué pueden hacer los sistemas con él.
- ✓Nombrado por propósito — definición, advertencia, comparación, fuente y CTA describen funciones, no estilos visuales.
- ✓Acotado por parámetros — etiquetas, elementos, citas, variantes y límites evitan que las estructuras improvisadas se desvíen.
- ✓Ubicado por regla — una respuesta inicial, una advertencia en el flujo, un bloque de fuentes al final y un CTA del siguiente paso ocupan diferentes partes del documento.
- ✓Renderizado por canal — un elemento puede convertirse en HTML semántico en Hugo, un bloque nativo de WordPress, datos estructurados o un registro de feed.
Qué es un elemento de contenido
El texto libre almacena oraciones. Un elemento de contenido almacena oraciones más un registro explícito de lo que esas oraciones hacen.
Un autor añade un H2 llamado "¿Qué es la rotación de clientes?", lo sigue con un párrafo y puede dar negrita a la primera oración. Un lector puede inferir que es una definición. El sistema de contenido solo ve un encabezado y prosa.
Nada registra si la definición es canónica, si debe estar cerca del inicio, qué término define, cuánto puede durar o si otro canal puede reutilizarla.
El autor inserta un elemento definition con un term, un body conciso y un calificador opcional. El contrato del elemento controla la ubicación, el marcado accesible, la extensión y la presentación.
Una plantilla puede renderizarlo, una auditoría puede encontrarlo, una migración puede mapearlo y un sistema de respuesta puede distinguir la definición de la explicación circundante.
Un elemento es un bloque de contenido nombrado, tipificado y parametrizado. "Nombrado" le da una identidad estable. "Tipificado" lo conecta con un comportamiento. "Parametrizado" significa que sus partes significativas son campos en lugar de un blob indiferenciado. También lleva reglas de posición, límites de contenido, variantes, requisitos de accesibilidad, mapeos de esquema y controles de calidad.
Esto no elimina la prosa. Una definición, advertencia o nota de fuente aún necesita una redacción precisa. Elimina la ambigüedad sobre la función de la prosa. El lenguaje puede variar mientras se respeta el contrato, así como diferentes registros contienen diferentes datos mientras comparten un mismo esquema.
Por qué los elementos superan a los briefs de contenido
Un brief de prosa puede describir la página deseada. Los elementos tipificados preservan sus decisiones importantes después de que el brief abandona la pantalla del editor.
El objetivo no es que cada página se vea idéntica. Es que las funciones repetidas se comporten de manera predecible. Un caso de estudio y una página de glosario pueden tener voces y diseños diferentes mientras sus fuentes sigan siendo consultables y sus bloques de contenido relacionado sigan siendo gobernados.
La regla de precedencia de elementos
Si el propósito de un elemento coincide con lo que hace la sección, ese elemento es obligatorio, incluso si un encabezado y un párrafo pudieran mostrar las mismas palabras. El texto libre es la alternativa, no la opción por defecto.
No busques solo la etiqueta en el esquema. "Consideraciones clínicas" puede ocultar una advertencia. "De un vistazo" puede significar conclusiones clave. Nombra la tarea del lector: definir, resumir, advertir, comparar, instruir, probar, navegar o convertir.
Luego revisa las declaraciones de propósito. Un propósito coincidente tiene prioridad sobre un encabezado personalizado porque el tipo preserva la función fuera de la página visible.
El texto libre es adecuado para análisis, transiciones, ejemplos y explicaciones sin un contrato reutilizable. Debe conectar elementos y desarrollar el argumento, no hacerse pasar por un componente existente.
Si un patrón de texto libre se repite, regístralo para revisión de la biblioteca. La repetición puede revelar un elemento faltante, pero los autores no deben crear componentes no oficiales página por página.
| Redacción del esquema | Propósito | Elección requerida | Qué pierde la prosa |
|---|---|---|---|
| "¿Qué es X?" | Dar un significado acotado | cuadro de definición | La definición no puede separarse de forma fiable del contexto. |
| "Cuándo buscar ayuda" o "contraindicaciones" | Indicar riesgo, consecuencia y acción segura | cuadro de advertencia | Una condición de parada no tiene semántica de advertencia. |
| Un consejo práctico | Ofrecer consejo de ejecución opcional | cuadro de consejo | El consejo compite con los pasos necesarios o desaparece dentro de ellos. |
| El resumen al inicio | Presentar conclusiones respaldadas | conclusiones clave | Una lista suelta no tiene ubicación, límite ni significado de resumen. |
| Una lista para marcar | Seguir estados de finalización | Elemento de lista de verificación | Las viñetas no distinguen acciones de observaciones ni estados. |
El ejemplo de lista de verificación no está enlazado porque su especificación detallada pertenece a una ola posterior de la biblioteca. La decisión de precedencia sigue aplicando: usa una implementación de lista de verificación aprobada cuando el CMS la proporcione; no disfraces estados de finalización como viñetas decorativas.
Bloques tipificados vs texto plano
La oración visible es idéntica. La versión tipificada conserva la identidad y los campos que los sistemas downstream pueden usar sin adivinar.
La rotación de clientes es la pérdida de clientes o suscriptores durante un período medido.
Almacenado como
{ "heading": "What is customer churn?",
"html": "<p>Customer churn is…</p>" }Salida de la máquina: encabezado y HTML genérico. El estado de definición, el término, la ubicación y la reutilización son desconocidos.
La rotación de clientes es la pérdida de clientes o suscriptores durante un período medido.
Almacenado como
{ "type": "definition",
"term": "customer churn",
"body": "Customer churn is…",
"position": "opening" }Salida de la máquina: una definición conocida con campos direccionables, validación, renderizado semántico, mapeo de esquema y elegibilidad para feeds.
La diferencia es funcional, no cosmética. Reemplaza el componente con un encabezado y un párrafo y el lector puede no notar nada, mientras que el sistema pierde validación, analíticas, mapeo de esquema, lógica de migración y consultas de cartera. Intercambiar un elemento tipificado por texto libre es una pérdida de función.
Los once grupos de elementos
Cada tarjeta activa refleja los metadatos playbookFamily de las páginas hijas. Los recuentos describen la biblioteca de elementos publicada; el resto está planificado para oleadas posteriores.
Lee primero: la regla de precedencia que rige todos los demás elementos.
El registro que impulsa la identidad, el descubrimiento y el esquema.
La primera pantalla: respuesta, resumen, definición, orientación.
Cuadro de definición · Bloque de respuesta directa · Sello de actualidad · Gancho de introducción · Cuadro de conclusiones clave · Índice de contenidos · ¿Para quién es esto? Reglas de bloque de audiencia
Los bloques que sustentan el argumento.
Acordeón · Listas con viñetas · Lista de verificación · Listados personalizados · Árbol de decisión · Qué hacer y qué no hacer · Reglas de párrafo de texto libre · Sistema de encabezados · Caja de iconos · Caja de imagen · Infobox · Infobox · Listas de pasos · Pestañas / Cambiador de persona · Líneas de tiempo · Secciones en zigzag
Datos estructurados que tanto un lector como una máquina pueden usar.
Incrustaciones de calculadora · Bloques de gráficos · Tablas comparativas · Tablas de precios · Bloques de pros y contras · Tarjetas de puntuación · Tablas de especificaciones · Barras de estadísticas
Consejos, notas y advertencias: usa con moderación o no los uses.
Cuadro de nota · Notificación · Cuadro de consejo · Cuadro de advertencia
Imágenes, vídeo, diagramas y sus equivalentes textuales.
Capturas de pantalla anotadas · Incrustaciones de audio y podcast · Diagramas e ilustraciones · Galería de imágenes · Imágenes en línea · Vídeo en línea · Incrustaciones de vídeo
Producto, precio, disponibilidad y composición.
Bloques de disponibilidad · Bloques de composición · Cajas de oferta · Tarjetas de producto · Carruseles de producto
Autoría, revisión, citas y prueba social.
Bloque de biografía del autor · Bloque de descargo de responsabilidad · Cita destacada y cita de experto · Bloque de revisado por · Bloques de reseñas · Fuentes y referencias · Testimonios · Insignias de confianza y certificaciones · Registro de actualizaciones
Enlaces, anclas y la siguiente acción.
Enlaces de ancla · Migas de pan · Bloques CTA · Enlaces de términos del glosario y tooltips · Botón CTA en línea · Módulos de enlaces internos · Mini banner · Captura de boletín · Bloques de contenido relacionado
Horarios, dirección, mapa y reservas.
Bloques de reserva · Bloques de horario y contacto · Bloques de mapa · Bloques NAP
Cómo termina una página y qué pregunta a continuación.
Secciones FAQ · Bloques de próximos pasos · Bloque de resumen
Un elemento, tres formatos
Cada elemento tiene un contrato conceptual y adaptadores para Markdown portable, Hugo y WordPress.
Considera un consejo con un título y un cuerpo de consejo opcional. Su propósito, contenido permitido, rol de accesibilidad, posición y reglas de control de calidad se mantienen constantes. Solo cambia la notación.
:::tip{title="Keep the query stable"}
Change one variable at a time.
:::Legible en fuente e independiente del tema del sitio.
{{< callout type="tip" title="Keep the query stable" >}}
Change one variable at a time.
{{< /callout >}}El adaptador mapea los campos nombrados al componente aprobado.
<!-- wp:amicited/tip
{"title":"Keep the query stable"} -->
<p>Change one variable at a time.</p>
<!-- /wp:amicited/tip -->Los controles nativos del editor preservan el mismo tipo y campos.
La portabilidad no es copiar HTML renderizado. Cada adaptador acepta la misma entrada significativa, aplica restricciones equivalentes y produce una salida apropiada para el canal. Si un campo no puede mapearse de forma segura, el adaptador debe fallar visiblemente o documentar una alternativa controlada; no debe descartar el significado en silencio.
Qué hay en cada página de elemento
Cada página de detalle es una guía pública y una especificación de producción. Elimina las suposiciones que de otro modo regresan en cada implementación.
| Área | Pregunta respondida | Fallo prevenido |
|---|---|---|
| Propósito y no propósito | ¿Qué función cumple y qué función similar pertenece a otro lado? | Un consejo que lleva un paso obligatorio o una definición que se convierte en un miniartículo. |
| Tabla de parámetros | ¿Qué campos son obligatorios, opcionales, tipificados, repetibles y limitados? | Adaptadores que aceptan datos diferentes o varias ideas ocultas en un solo campo. |
| Reglas de posición | ¿Dónde puede aparecer, con qué frecuencia y junto a qué? | Conclusiones enterradas en medio de la página o fuentes desconectadas de las afirmaciones. |
| Galería de variantes | ¿Qué variantes nombradas existen y cuándo es apropiada cada una? | Variaciones visuales únicas que se hacen pasar por variantes oficiales. |
| Bueno vs malo | ¿Qué hace un ejemplo correcto que un fallo plausible no logra? | Equipos que copian la sintaxis pero pierden el propósito. |
| Mapeo de esquema | ¿Cómo se mapean los campos a HTML, accesibilidad, esquema, API y feeds? | Contenido visible que discrepa de la salida de la máquina. |
| Control de calidad | ¿Qué puede automatizarse y qué necesita criterio humano? | Un bloque válido que se publica con contenido vago, falso, desactualizado o mal ubicado. |
La automatización puede verificar campos obligatorios, recuentos, longitudes, ubicación, identificadores, URL y compatibilidad de adaptadores. El control de calidad editorial debe verificar precisión, utilidad, calidad de la evidencia, énfasis proporcionado y si el elemento es adecuado para la tarea del lector.
Qué elementos son obligatorios
Obligatorio significa que el sistema espera la función en prácticamente cada tipo de publicación completo. No significa que cada bloque deba ser grande o idéntico.
- Frontmatter establece identidad, propiedad, descubrimiento y uniones.
- Introducción confirma el alcance y la adecuación para el lector.
- Conclusiones clave presentan conclusiones respaldadas en páginas sustanciales.
- FAQ resuelve preguntas residuales genuinas.
- Fuentes hacen que el respaldo factual sea trazable.
- Contenido relacionado proporciona la siguiente ruta de aprendizaje.
- CTA ofrece una acción proporcionada.
- Usa una definición cuando un término necesite un significado acotado.
- Usa una respuesta directa para una pregunta principal clara.
- Usa pasos para un procedimiento ordenado y un resultado verificable.
- Usa comparaciones cuando los lectores evalúen alternativas con criterios consistentes.
- Usa un consejo para una mejora opcional y una advertencia para riesgo material.
- Usa multimedia anotada cuando lo visual comunique algo que la prosa no puede hacer con la misma eficiencia.
Las excepciones importan. Una definición breve de glosario puede no necesitar conclusiones clave separadas. Una página sin ninguna afirmación factual respaldada externamente puede no necesitar referencias visibles. Un FAQ con preguntas inventadas es peor que ninguno. Las especificaciones de tipo de publicación establecen valores por defecto; los autores documentan omisiones justificadas en lugar de llenar espacios mecánicamente.
Comienza con la especificación de tipos de publicación relevante, que ordena los elementos habituales para la tarea del lector. Luego aplica la precedencia sección por sección. El resultado no es ni una página en blanco ni un formulario rígido: es un ensamblaje gobernado con espacio para argumentos originales, evidencia, ejemplos y voz propia.
Los elementos tipificados permiten que un agente ensamble en lugar de inventar
La biblioteca de elementos es donde un sistema de contenido deja de ser un documento y se convierte en algo que una máquina puede ejecutar. Un bloque con campos declarados o bien tiene lo que necesita o visiblemente no lo tiene.
Una tabla comparativa necesita opciones comparables, una dimensión declarada por fila y una fecha de verificación. Cuando uno de esos insumos no existe, un bloque tipificado le da al agente un lugar donde fallar de forma notoria.
La prosa libre no tiene esa propiedad. Si se le pide una tabla sin datos detrás, un agente produce una tabla de todos modos, y la celda inventada se ve exactamente igual que una investigada.
Revisa la biblioteca por propósito antes de escribir un encabezado. Esa instrucción es seguida de forma mucho más fiable por un agente que por una persona con plazos ajustados, porque un agente realmente releerá toda la biblioteca cada vez.
Este es un caso donde el agente es el mejor operador: la regla es mecánica, y lo mecánico es para lo que sirven los agentes.
Cada elemento se define una vez y se expresa como una directiva Markdown portable, un shortcode de Hugo y un bloque de WordPress. El agente trabaja con la forma portable y nunca necesita saber en qué CMS termina la salida.
Eso también significa que cambiar de CMS no invalida el sistema de contenido ni requiere reentrenar al agente.
Debido a que los elementos están tipificados, el corpus puede ser consultado. Qué páginas carecen de un bloque de fuentes. Qué tablas comparativas no tienen fecha de verificación. Qué respuestas directas exceden su límite.
Solo puedes ejecutar esa auditoría sobre contenido ensamblado a partir de bloques nombrados. La prosa no es consultable, por lo que el control de calidad basado en prosa no escala más allá del número de páginas que una persona puede leer.
Cada página de elemento lleva una tabla de parámetros con campos obligatorios, mínimos y máximos, reglas de posición y una lista de verificación de control de calidad. Ese es el nivel de precisión que un agente necesita para construir sin adivinar, y esa misma precisión hace que la salida sea revisable por un humano en una fracción del tiempo.
FAQ de elementos de contenido
Un elemento de contenido es un bloque nombrado, tipificado y parametrizado con un propósito definido, campos permitidos, reglas de posición, límites de extensión, comportamiento de representación y controles de calidad. Almacena contenido y función.
Usa texto libre cuando ningún elemento de la biblioteca coincida con el propósito. El análisis, la narrativa, las transiciones y las explicaciones únicas suelen permanecer como prosa; las definiciones establecidas, advertencias, comparaciones, fuentes y CTA no.
No. El contrato estandariza la estructura y la función, no las conclusiones ni la voz. Los autores aún eligen argumentos, evidencia, ejemplos y redacción.
Sí. El contrato portable es independiente de la presentación. Los adaptadores mapean los mismos campos a sintaxis y marcado nativos mientras preservan la validación y la semántica.
Construye una página a partir de bloques que puedas gobernar a escala
Revisión gratuita · Prueba de 7 días · se requiere tarjeta de crédito