Títulos (básico)
Empieza la línea con de una a seis marcas #, y luego un espacio. Cuantas más marcas #, más pequeño es el título.
# Title
## Section
### Subsection
El espacio importa. Siete marcas # no son un título.
Párrafos y saltos de línea (básico)
Una línea en blanco empieza un párrafo nuevo. Un solo salto de línea dentro de un párrafo no rompe la línea. El texto sigue corriendo.
Para un salto de línea sin párrafo nuevo, termina la línea con dos espacios o con una barra invertida:
First line\
Second line
Negrita, cursiva y tachado
*italic* or _italic_
**bold** or __bold__
***bold and italic***
~~strikethrough~~
La cursiva y la negrita son básicas. El tachado es GFM. Usa los asteriscos si la marca está dentro de una palabra, porque _ no funciona dentro de una palabra.
Listas
- Apples
- Bananas
- Green ones
- Yellow ones
1. Wake up
2. Make tea
3. Read
- [ ] Write the draft
- [x] Send the draft
Las viñetas pueden empezar con -, + o *. Las listas numeradas usan un número y un . o ). El primer número establece dónde empieza la lista.
Para anidar una lista, sangra la lista interior para que quede alineada con el texto del elemento de arriba. Para - Bananas, son dos espacios.
Las viñetas y los números son básicos. Las listas de tareas, las casillas [ ] y [x], son GFM.
Enlaces
[PilcrowMD](https://pilcrowmd.com "Optional title")
<https://pilcrowmd.com>
https://pilcrowmd.com
El primero es un enlace en línea: el texto entre corchetes y la dirección entre paréntesis. El segundo es un enlace automático entre ángulos. Los dos son básicos.
El tercero es una dirección sin marcas. CommonMark no la convierte en un enlace. GFM sí, para las direcciones que empiezan por http://, https:// o www..
Enlaces a un título
Para saltar a un título del mismo archivo, enlaza a su ancla:
## My first section
[Go to the section](#my-first-section)
El enlace es un enlace en línea normal. En GitHub, el ancla se forma a partir del texto del título: letras minúsculas, espacios convertidos en guiones y el resto de signos de puntuación eliminados. A un segundo título con el mismo texto se le añade -1. Otras apps pueden construir las anclas de la misma manera, pero es una regla de GitHub, así que pruébalo.
Imágenes
Igual que un enlace, con un ! delante:

El texto entre corchetes es la descripción (el texto alternativo). La sintaxis de las imágenes es básica.
Citas (básico)
Empieza cada línea con >:
> The best way to learn is to try.
Código
Para un fragmento corto de código dentro de una frase, usa acentos graves simples:
Run `npm test` before you commit.
Para mostrar un acento grave dentro del código, rodea el código con acentos graves dobles.
Para un bloque, usa una valla de tres acentos graves. Escribe el nombre del lenguaje después de la valla de apertura:
```python
print("Hello")
```
Las vallas también se pueden hacer con tres tildes ~~~. El nombre del lenguaje es opcional. Las apps lo usan para colorear el código. Todo esto es básico.
Línea horizontal (básico)
Tres o más -, * o _ en una línea aparte:
---
Deja una línea en blanco encima de ---. Justo debajo de una línea de texto, convierte ese texto en un título.
Tablas (GFM)
Una tabla necesita una fila de encabezado, una fila de guiones y filas de datos:
| Fruit | Price |
|--------|-------|
| Apple | 1.20 |
Las tablas tienen más reglas, como la alineación y el escape de la barra vertical. Consulta Tablas en Markdown: cómo escribirlas y leerlas.
Escape: mostrar una marca como texto (básico)
Pon una barra invertida delante de una marca para mostrarla como texto sin formato:
\*not italic\*
Cualquier signo de puntuación se puede escapar así. Las barras invertidas no funcionan dentro del código.
Notas al pie (función de GitHub)
This claim needs a source.[^1]
[^1]: Here is the source.
Las notas al pie no están en CommonMark ni en la especificación GFM. GitHub las admite. El texto de la nota aparece al final de la página, dondequiera que lo escribas en el archivo. GitHub no admite notas al pie en las wikis.
Avisos (función de GitHub)
Un aviso es una cita con una etiqueta en la primera línea:
> [!NOTE]
> Useful information the reader should know.
Los tipos son NOTE, TIP, IMPORTANT, WARNING y CAUTION. No están en ninguna de las dos especificaciones. Úsalos con moderación.
Cómo leer Markdown
En un editor de texto sin formato, todas estas marcas siguen visibles. Un lector de Markdown las convierte en una página limpia.
PilcrowMD muestra tablas, notas al pie, avisos al estilo de GitHub y enlaces que saltan a un título, en Android y Mac. En Mac también muestra listas de tareas.
Preguntas frecuentes
¿Qué Markdown debería aprender primero? Las marcas básicas: títulos, negrita, cursiva, listas, enlaces, código y citas. Funcionan en todas las apps de Markdown. Añade después las tablas y las listas de tareas, porque la mayoría de las apps admiten GFM.
¿Por qué mi Markdown se ve distinto en otra app? Las apps siguen reglas distintas. CommonMark es la base, GFM la amplía y algunas funciones, como las notas al pie y los avisos, no están en ninguna de las dos. Si una marca no funciona, probablemente la app no la admite.
¿Tengo que dejar un espacio después de # y -? Sí. Escribe # Title y - Item. Sin el espacio, la línea sigue siendo texto sin formato.
También en Mac: PilcrowMD para Mac (beta)