Markdown

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004 con un objetivo claro: que el texto con formato fuera tan legible en crudo como renderizado. Hoy es el formato de escritura de facto para documentación técnica, READMEs, wikis, blogs y plataformas de notas como Obsidian o Notion. Un archivo .md es texto plano que cualquier editor abre, pero que cualquier renderizador convierte en HTML limpio.

Sintaxis básica: encabezados, énfasis y listas

Encabezados: se forman con almohadillas. Uno, dos o tres # equivalen a <h1>, <h2> y <h3>:

# Título principal
## Sección
### Subsección

Énfasis:

**negrita**   o   __negrita__
*cursiva*     o   _cursiva_
***negrita y cursiva***
~~tachado~~

Listas:

- Elemento A
- Elemento B
  - Subelemento B1

1. Primer paso
2. Segundo paso
3. Tercer paso

¿Cómo se incluye código en Markdown?

Para código en línea, rodea el texto con comillas invertidas simples:

Usa `console.log()` para depurar en JavaScript.

Para bloques de código, usa tres comillas invertidas y añade el nombre del lenguaje para coloreado de sintaxis:

```js
function suma(a, b) {
  return a + b;
}
```

La mayoría de renderizadores (GitHub, VS Code, Obsidian) destacan la sintaxis automáticamente con el nombre del lenguaje.

Tablas, enlaces e imágenes

Tablas:

| Columna A | Columna B | Columna C |
|-----------|:---------:|----------:|
| Izquierda | Centrado  | Derecha   |
| Valor 1   | Valor 2   | Valor 3   |

Los : en la línea de separadores controlan la alineación de la columna.

Enlaces e imágenes:

[Texto del enlace](https://gliora.es)
[Enlace con título](https://gliora.es "Gliora - Calculadoras")

![Texto alternativo](ruta/imagen.png)

Para abrir un enlace en nueva pestaña (target="_blank") necesitas HTML puro; la sintaxis de Markdown estándar no lo soporta.

¿Qué variante de Markdown debo usar?

El Markdown original de Gruber no estaba estandarizado, lo que generó variantes incompatibles:

La mayoría de plataformas usan GFM o una variante compatible con CommonMark. Si necesitas máxima compatibilidad, CommonMark es la apuesta segura.

Convertir Markdown a otros formatos

Pandoc es la herramienta de referencia para conversión entre formatos:

# Markdown → HTML
pandoc articulo.md -o articulo.html

# Markdown → PDF (requiere una distribución LaTeX instalada)
pandoc articulo.md -o articulo.pdf

# Markdown → Word
pandoc articulo.md -o articulo.docx

Para una conversión rápida sin instalar nada, editores como VS Code (con la extensión Markdown Preview Enhanced), Obsidian o Typora permiten exportar a PDF directamente desde el editor.

Markdown y frontmatter YAML

Muchos generadores de sitios estáticos (Astro, Jekyll, Hugo) añaden un bloque de metadatos YAML al inicio del archivo .md, delimitado por ---:

---
title: "Mi artículo"
date: 2026-08-31
tags: [web, markdown]
---

Aquí empieza el contenido del artículo.

Este bloque se llama frontmatter y permite añadir metadatos (título, fecha, etiquetas) que el generador usa para construir la página sin que aparezcan en el HTML final. El YAML del frontmatter sigue las mismas reglas que cualquier otro YAML: indentación con espacios, cadenas con caracteres especiales entre comillas.