📄
← Volver a guías

Guía de sintaxis de Markdown: referencia completa con ejemplos

· Etiquetas: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference

Guía de sintaxis de Markdown

Markdown es un lenguaje de marcado ligero que convierte texto plano en HTML con formato. Creado por John Gruber en 2004, se ha convertido en el formato de escritura estándar para documentación, archivos README y contenido técnico en toda la web.

Encabezados

Usa símbolos #. Un # para el nivel superior, hasta seis para el más profundo:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Los niveles deben aumentar de uno en uno — saltar de ## a #### puede confundir a los lectores de pantalla.

Formato de texto

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

Enlaces

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Imágenes

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

El texto alternativo es fundamental para la accesibilidad y el SEO — se muestra cuando las imágenes no se cargan.

Listas

Las listas desordenadas usan -, * o +. Las listas ordenadas usan números:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

Código

El código en línea usa comillas invertidas simples: `printf()`.

Los bloques de código usan comillas invertidas triples con un identificador de lenguaje opcional:

```python
def greet(name):
    return f"Hello, {name}!"


Lenguajes admitidos: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Citas en bloque

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

Son habituales para destacados, notas y citas de fuentes externas.

Reglas horizontales

Tres o más guiones, asteriscos o guiones bajos en una línea:

---
***
___

Tablas

Las barras verticales y los guiones definen las columnas. Los dos puntos controlan la alineación:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

Extensiones de GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) añade funciones útiles:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM también enlaza URLs automáticamente — www.example.com se vuelve clicable sin necesidad de envolverlo en < >.

Escapar caracteres especiales

Prefija con \ para mostrar caracteres Markdown literales:

\*This is not italic\*
\# This is not a heading

Caracteres que necesitan escape: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Vista previa de Markdown en línea

Usa la herramienta de vista previa de Markdown para escribir y previsualizar Markdown en tiempo real. La vista previa en vivo se actualiza mientras escribes, mostrando exactamente cómo se renderizarán los encabezados, enlaces, imágenes, bloques de código y tablas.

Guía de sintaxis de Markdown: referencia completa con ejemplos - CoolTool