El Flujo de Trabajo con Editor Markdown: Escribir Más Rápido con Texto Plano

Sintaxis Básica de Markdown que Todo Escritor Debería Conocer

La curva de aprendizaje de Markdown es poco pronunciada porque la mayor parte de su sintaxis es intuitiva. Los encabezados usan almohadillas: # para H1, ## para H2, ### para H3 — hasta seis niveles. El texto en negrita usa doble asterisco: **importante** se renderiza como importante. La cursiva usa asterisco simple o guión bajo: *nota* o _nota_. El código en línea usa acentos graves: `const x = 1`. Estos cinco patrones cubren el formato que necesitas para el 80% de los documentos.

Los enlaces siguen el patrón [texto visible](URL). Las imágenes extienden el mismo patrón con un signo de exclamación: . Las listas no ordenadas usan un guión o asterisco al inicio de la línea: - elemento. Las listas ordenadas usan números: 1. primer elemento. Las citas en bloque usan el símbolo mayor que: > Esto es una cita. Las reglas horizontales usan tres o más guiones solos en una línea: ---.

Los bloques de código — esenciales para la escritura técnica — usan triple acento grave. Un bloque de código delimitado con una etiqueta de lenguaje habilita el resaltado de sintaxis en los renderizadores que lo admiten: ```javascript en la línea de apertura seguido de tu código y un ``` de cierre. Para el código en línea dentro de una oración, usa acentos graves simples. Estos dos patrones cubren todas las necesidades de formato de código.

Botones de la Barra de Herramientas vs. Atajos de Teclado

• Los botones de la barra de herramientas (Negrita, Cursiva, Enlace, etc.) funcionan envolviendo el texto seleccionado — selecciona el texto primero, luego haz clic en el botón
• Los botones de encabezado (H1, H2) añaden el prefijo # al inicio de la línea actual — no necesitas seleccionar nada
• Los botones de Lista y Cita en bloque también actúan sobre la línea actual — posiciona el cursor en cualquier parte de la línea
• Para insertar una regla horizontal o un bloque de código, posiciona el cursor donde lo quieres y haz clic — la sintaxis se inserta en la posición del cursor
• Para ediciones de varias líneas (por ejemplo, convertir varias líneas en una lista), la mayoría de los editores requieren hacerlo línea por línea mediante la barra de herramientas

Estructurar Documentos Largos en Markdown

Para documentos de más de unos pocos párrafos, la jerarquía de encabezados es el elemento estructural más importante. Usa un H1 para el título del documento y H2 para las secciones principales. H3 y por debajo son para subsecciones. Evita saltarte niveles (H1 directamente a H3) — esto confunde tanto a los lectores como a las herramientas automatizadas que generan tablas de contenido a partir de la estructura de encabezados.

Las reglas horizontales (---) son útiles como separadores visuales de sección en documentos largos, pero úsalas con moderación. En Markdown, una regla horizontal separa visualmente el contenido pero no tiene ningún significado semántico para los esquemas de documentos. Si te encuentras añadiendo muchas reglas horizontales, probablemente significa que necesitas una jerarquía de encabezados en su lugar.

El front matter — metadatos al inicio de un archivo Markdown en formato YAML, delimitados por --- --- — es compatible con la mayoría de los generadores de sitios estáticos y herramientas de documentación. Los campos comunes de front matter incluyen title, description, date, tags y author. Incluir front matter desde el principio hace que los documentos sean inmediatamente compatibles con Jekyll, Hugo, Astro, VitePress y plataformas similares sin modificación.