Cómo estructurar un artículo en Markdown para tu blog: Guía paso a paso

Markdown es uno de los lenguajes más simples y potentes para escribir contenido web. Es ideal para blogs, documentación, y contenido técnico, y cuando lo estructuras correctamente, también puede ser muy amigable para el SEO.

En esta guía te enseño paso a paso cómo crear un archivo Markdown profesional, explicando cada parte con ejemplos y consejos prácticos.

Índice

1. Frontmatter: metadatos esenciales

---
title: "Título optimizado con palabra clave"
description: "Resumen claro para Google y redes sociales"
pubDate: "YYYY-MM-DD"
author: "Tu nombre"
image: "/ruta/imagen.jpg"
tags: ["palabra1", "palabra2", "tema"]
---

🔍 ¿Por qué es importante?

  • Es lo que los motores de búsqueda leen primero
  • Se usa para los previews en redes sociales
  • Ayuda a ordenar tus artículos si usas frameworks como Astro, Next.js, etc.

2. Título principal del artículo

# Cómo estructurar un artículo en Markdown

🧠 Usa un solo # por artículo. Este será el <h1> en HTML.
Debe contener la palabra clave principal y explicar claramente el tema.

3. Índice del contenido (opcional pero útil)

## Índice

- [Sección 1](#sección-1)
- [Sección 2](#sección-2)

✅ Es muy útil para artículos largos. Ayuda a que los lectores naveguen mejor y mejora el SEO.

4. Encabezados bien jerarquizados

Usa ## para secciones principales (<h2>), ### para subsecciones (<h3>), etc.

## Introducción

### Conceptos básicos

### Consejos extra

💡 No te saltes niveles. No uses ### si no has usado antes ##.

5. Imágenes, listas, y citas

Imágenes

![Texto alternativo](https://tusitio.com/imagen.jpg)

Listas

- Elemento 1
- Elemento 2

Citas

> Esto es una cita o nota

📌 Usa texto alternativo descriptivo en las imágenes para mejorar accesibilidad y SEO.

6. Buenas prácticas SEO en Markdown

  • Usa tu palabra clave principal en:
    • El título (#)
    • Primer párrafo
    • Subtítulos (##)
    • Enlaces internos y externos
  • Usa listas, negritas y tablas para mejorar legibilidad
  • Usa imágenes optimizadas y con nombre descriptivo

7. Plantilla completa de ejemplo

---
title: "Cómo crear enlaces de WhatsApp personalizados"
description: "Aprende cómo generar links de WhatsApp con mensaje para redes sociales y páginas web."
pubDate: "2025-07-19"
author: "Leandro Fuentes"
image: "/blog/enlace-whatsapp.jpg"
tags: ["whatsapp", "herramientas", "marketing"]
---

# Cómo crear enlaces de WhatsApp personalizados

## Índice

- [¿Qué es un enlace de WhatsApp?](#qué-es-un-enlace-de-whatsapp)
- [Ventajas](#ventajas)
- [Cómo crearlo](#cómo-crearlo)

## ¿Qué es un enlace de WhatsApp?

Un enlace de WhatsApp abre una conversación con un número definido...

## Ventajas

- Es rápido
- Es directo

## Cómo crearlo

```text
https://wa.me/56912345678?text=Hola

---

## Conclusión

Estructurar correctamente tus artículos en Markdown no solo mejora la experiencia del lector, también mejora el SEO y te ahorra trabajo cuando escales tu blog.

¿Listo para escribir el siguiente artículo como un pro?