Guía rápida de Markdown: sintaxis con vista previa en vivo

De uno a seis # seguidos de un espacio. Usa un solo encabezado # por documento y no te saltes niveles; los lectores de pantalla y los índices dependen del orden.

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

El estilo "setext", más antiguo; solo niveles 1 y 2. Una línea de --- bajo un párrafo lo convierte en encabezado, lo que sorprende a quien espera una línea horizontal: deja una línea en blanco antes de ---.

Heading 1
=========

Heading 2
---------

Una línea en blanco separa los párrafos. Un salto de línea simple dentro de un párrafo se une en una sola línea (salvo donde se indica en saltos de línea).

First paragraph, which can wrap
across several source lines.

Second paragraph after a blank line.

Para un salto de línea sin nuevo párrafo, termina la línea con dos espacios o una barra invertida. Los comentarios de GitHub, Obsidian (por defecto), Slack y Discord tratan cada salto de línea como salto.

Two trailing spaces  
make a break.
A trailing backslash\
works too.<br>So does an HTML br.

Los asteriscos funcionan dentro de palabras; los guiones bajos no (nombres_en_snake_case se quedan literales), por eso la mayoría de guías de estilo prefieren *.

**bold** or __bold__

*italic* or _italic_

***bold italic***

in**side**word works with *, not with _

Empieza cada línea con >. Las citas pueden contener cualquier otro Markdown, incluidas listas y código.

> Quoted text.
> Still quoted.
>
> > Nested quote.

-, * o + funcionan; no los mezcles en una misma lista (otro marcador empieza una lista nueva).

- Item
- Item
  - Nested (indent 2 spaces)
- Item

El primer número fija el inicio; los siguientes se ignoran, así que con "1." en todas las líneas la lista se renumera sola al reordenar elementos.

1. First
1. Second
1. Third

3. Starts at three
4. Four

Sangra el contenido adicional para alinearlo con el primer carácter del texto del elemento (3 espacios después de "1. ").

1. Install:

   ```sh
   npm install marked
   ```

2. Indent continuation lines
   to the item text.

El Markdown entre comillas invertidas no se interpreta.

Run `npm test` now.

Use ``double `backticks` `` when the code contains one.

Tres comillas invertidas (o ~~~) en líneas propias. La palabra tras la apertura indica el lenguaje para el resaltado de sintaxis en GitHub, GitLab, Obsidian y Discord.

```js
const answer = 42;
console.log(answer);
```

const answer = 42;
console.log(answer);

La sintaxis original. Las vallas son más claras y permiten indicar el lenguaje; el código con sangría es la única forma que entiende el Reddit antiguo.

Paragraph.

    four spaces of indent
    make a code block

four spaces of indent
make a code block

Tres o más -, * o _ en una línea propia, con una línea en blanco encima.

Above

---

Below (also *** or ___)

La forma entre ángulos es el enlace automático de CommonMark. Los espacios de una URL deben escribirse %20 o la URL debe ir entre <…>.

[Link text](https://freetoolsforweb.com)

[With a title](https://freetoolsforweb.com "Hover text")

[Relative link](/tools/regex-cheat-sheet)

<https://example.com>

Saca las URL largas del texto. Las definiciones pueden ir en cualquier parte del documento y no se muestran.

Read the [spec][cm] and the [GFM spec].

[cm]: https://spec.commonmark.org/
[GFM spec]: https://github.github.com/gfm/

En GitHub y GitLab cada encabezado recibe un id automático: en minúsculas, espacios a guiones, sin puntuación ("## Install & Run" pasa a #install--run). Obsidian usa [[#Encabezado]].

[Jump to tables](#md-tables)

Como un enlace con ! delante. El texto entre [ ] es el texto alternativo: describe la imagen para quien no puede verla. Markdown no tiene sintaxis de tamaño; usa HTML <img width="200"> donde se permita HTML.

![Site logo](/brand/favicon.svg "Optional title")

[![Clickable image](/brand/favicon.svg)](/tools)

Una barra invertida hace literal cualquier signo de puntuación ASCII: \ ` * _ { } [ ] ( ) # + - . ! |

\*not italic\*  \# not a heading  1\. not a list

CommonMark lo permite. GitHub y GitLab conservan un subconjunto seguro (sin script, style ni manejadores de eventos); Slack, Discord, Reddit y Notion lo muestran como texto.

Press <kbd>Ctrl</kbd> + <kbd>C</kbd>, H<sub>2</sub>O, x<sup>2</sup>.

Un comentario HTML se conserva en el código fuente pero no se muestra allí donde se permite HTML.

Visible.

<!-- Not rendered: notes for editors -->

Also visible.

La segunda línea es obligatoria; los dos puntos fijan la alineación. Las columnas no tienen que estar alineadas en el código. Escapa una barra vertical literal como \|. No hay celdas combinadas ni multilínea (usa <br> dentro de una celda en GitHub).

Dónde: GFM, GitLab, Obsidian, Reddit; Notion al pegar

| Left | Centre | Right |
| :--- | :----: | ----: |
| a    |   b    |     1 |
| `c`  | **d**  |    22 |

En GitHub y GitLab las casillas se pueden marcar en issues y pull requests y actualizan el código fuente.

Dónde: GFM, GitLab, Obsidian; Notion con el atajo []

- [x] Write the draft
- [ ] Review
- [ ] Publish

Dos virgulillas en todas partes; GitHub también acepta una. Slack usa ~una~ virgulilla, Jira -guiones-.

Dónde: GFM, GitLab, Obsidian, Discord, Reddit, Notion

~~no longer true~~

GFM convierte en enlaces las URL sueltas y las direcciones www. En CommonMark puro se quedan como texto salvo que vayan entre <…>.

Dónde: GFM, GitLab, Obsidian, Slack, Discord, Reddit

Visit https://freetoolsforweb.com or www.example.com.

La definición puede ir en cualquier parte; las notas se numeran por orden de referencia y se listan al final. Obsidian también tiene notas en línea: ^[así].

Dónde: GFM, GitLab, Obsidian (no CommonMark)

Markdown was created in 2004.[^1]

[^1]: By John Gruber, with Aaron Swartz.

Defines tú el ancla. Compatible con Pandoc, PHP Markdown Extra, Hugo, Jekyll (kramdown), MkDocs y Docusaurus; GitHub y GitLab lo ignoran y muestran las llaves, y usan ids automáticos.

Dónde: Pandoc, Hugo, Jekyll, MkDocs, Docusaurus; no GitHub ni GitLab

### Install {#setup}

Nombres entre dos puntos. Al escribir dos puntos en GitHub, Slack, Discord o Notion se abre un selector de emojis. Pegar el propio emoji funciona en todas partes.

Dónde: GitHub, GitLab, Slack, Discord; no Obsidian (sin plugin) ni CommonMark

Ship it :rocket: :+1: :tada:

TeX entre signos $ en línea, $$ para un bloque destacado. GitHub también acepta $`…`$ y un bloque ```math; GitLab admite las mismas formas. Notion usa $$…$$ para ecuaciones en línea.

Dónde: GitHub, GitLab, Obsidian, Notion (sintaxis propia)

Inline: $E = mc^2$

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

Un bloque de código con el lenguaje mermaid se convierte en diagrama: diagramas de flujo, de secuencia, de clases, de estados, de Gantt y ER.

Dónde: GitHub, GitLab, Obsidian, Notion (bloque de código Mermaid)

```mermaid
flowchart LR
  A[Write] --> B{Review}
  B -->|ok| C[Publish]
  B -->|changes| A
```

GitHub tiene cinco tipos: NOTE, TIP, IMPORTANT, WARNING, CAUTION. GitLab (17.10+) acepta la misma sintaxis. Obsidian tiene muchos más tipos, títulos personalizados (> [!tip] Título) y plegado (> [!faq]-).

Dónde: GitHub, GitLab 17.10+, Obsidian; una cita normal en los demás

> [!NOTE]
> Useful information.

> [!WARNING]
> Critical content that needs attention.

Es HTML, pero con amplia compatibilidad. Deja líneas en blanco alrededor del Markdown interior o no se interpretará.

Dónde: GitHub, GitLab, Obsidian, la mayoría de generadores de sitios estáticos

<details>
<summary>Click to expand</summary>

Hidden **Markdown** content.

</details>

Obsidian y algunos editores (Typora, iA Writer); GitHub muestra los signos igual. Usa <mark> donde se permita HTML.

Dónde: Obsidian, Typora; no GitHub

This is ==highlighted== text.