🎯 Objetivo
Aprender desde cero cómo escribir marcado semántico en formato JSON-LD para integrarlo directamente en el código HTML de tu web, con control total sobre los datos que expones.
📦 ¿Qué es JSON-LD?
JSON-LD significa JavaScript Object Notation for Linked Data. Es una forma de estructurar información en bloques independientes de JavaScript, separados del contenido visible, pero legibles por buscadores y LLMs.
Es el formato: ✅ Recomendado oficialmente por Google
✅ Utilizado por Schema Pro y otros plugins
✅ Compatible con cualquier CMS (WordPress, Joomla, Drupal…)
✅ Ideal para desarrollos a medida o avanzados
🧪 Estructura básica de un esquema JSON-LD
htmlCopiarEditar<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Cómo implementar Schema en WordPress",
"author": {
"@type": "Person",
"name": "Mario Gómez"
},
"datePublished": "2025-04-24"
}
</script>
🔹 Esto se inserta dentro del <head> o justo antes de cerrar el </body> de tu página.
📌 Componentes clave de un bloque JSON-LD
| Clave | Significado |
|---|---|
@context | Siempre «https://schema.org« |
@type | Tipo de entidad (Article, Product, Course, etc.) |
| Propiedades adicionales | Variables como name, author, price, etc. |
| Objetos anidados | Como author, offers, review, que tienen su propio tipo |
✍️ Cómo crearlo paso a paso
- Define qué tipo de Schema necesitas
- ¿Es un artículo? Usa
Article - ¿Es un producto? Usa
Product
- ¿Es un artículo? Usa
- Identifica qué información tienes y quieres marcar
- Usa la referencia oficial de Schema.org para consultar los campos
- Redacta el bloque JSON en un editor (Visual Studio Code, JSONLint, etc.)
- Añádelo al HTML de la página en WordPress o tu CMS (a mano o con plugin tipo “Insert Headers and Footers”)
🧰 Herramientas para generar JSON-LD fácilmente
Estas herramientas te permiten rellenar un formulario y obtener el bloque listo para copiar.
🔐 Validación del esquema
Una vez creado tu JSON-LD:
✅ Valídalo en:
💡 Ventajas del marcado manual
- 100 % personalizable
- Ideal para contenido dinámico o fuera del flujo de WordPress
- Puedes usarlo junto a otros datos en el mismo bloque
- Permite experimentar con campos nuevos antes de que los plugins los soporten
⚠️ Buenas prácticas
- No marques datos que no se muestran en pantalla
- No inventes valoraciones ni contenido
- Valida siempre antes de publicar
- Usa siempre comillas dobles
", no simples' - Si usas varios tipos, combínalos en un solo bloque JSON-LD si están relacionados
🛠️ Actividad práctica
- Elige una entrada o producto de tu web
- Redacta a mano el bloque JSON-LD correspondiente
- Usa herramientas para ayudarte si lo deseas
- Añádelo al HTML de la página o post
- Valida y compara resultados en Google y en ChatGPT (haciendo una pregunta sobre ese contenido)