
Los encabezados crean la estructura del documento y generan IDs de ancla en la mayoría de visores.
# Encabezado 1
## Encabezado 2
### Encabezado 3
#### Encabezado 4
##### Encabezado 5
###### Encabezado 6
Resultado:
✅ Usa un solo
#H1 por documento (el título). Empieza las secciones en##o inferior.
# → ###) salvo que tengas un motivo.{#id-personalizado} en algunos procesadores (Pandoc, algunos SSG).Separa párrafos con una línea en blanco:
Este es el primer párrafo.
Este es el segundo párrafo.
Resultado:
Este es el primer párrafo.
Este es el segundo párrafo.
Para un salto de línea dentro de un párrafo (sin nuevo párrafo):
Línea uno
Línea dos
Resultado:
Línea uno
Línea dos
💡 Dos espacios al final antes del salto de línea crean un
<br>. Algunos visores también aceptan\al final o la etiqueta HTML<br>.
| Estilo | Sintaxis | Resultado |
|---|---|---|
| Negrita | **negrita** o __negrita__ | negrita |
| Itálica | *itálica* o _itálica_ | itálica |
| Negrita itálica | ***negrita itálica*** | negrita itálica |
**texto en negrita**
*texto en itálica*
***negrita e itálica***
Resultado:
texto en negrita
texto en itálica
negrita e itálica
Extensión GFM (GitHub Flavored Markdown):
~~texto eliminado~~
Resultado:
texto eliminado
⚠️ No forma parte del Markdown original — compatible con GFM, Obsidian, VS Code y la mayoría de visores modernos.
[Texto del enlace](https://example.com)
[Enlace con título](https://example.com "Título al pasar el cursor")
[Archivo local](./documento.pdf)
[Archivo local absoluto](file:///C:/ruta/al/archivo.md)
Resultado:
Rutas locales: Usa barras inclinadas (
/) en las rutas, incluso en Windows. Para espacios en nombres de archivo, codifica con%20o envuelve la URL en< >. Prefiere rutas relativas cuando sea posible.
Define la URL por separado — útil para enlaces repetidos o un texto más limpio:
Visita [OpenAI][openai] o [Google][google].
[openai]: https://openai.com
[google]: https://google.com "Motor de búsqueda"
Resultado:
Muchos parsers enlazan automáticamente URLs y correos sueltos:
https://example.com
<https://example.com>
<usuario@example.com>
Resultado:
Misma sintaxis que los enlaces, con un ! al inicio:



Resultado:
Imágenes con estilo de referencia:
![Logo][logo]
[logo]: ./assets/logo.png "Logo del sitio"
Resultado:
HTML opcional para controlar el tamaño (cuando se permite HTML):
<img src="./foto.jpg" alt="Foto" width="300">
Resultado:
Usa -, * o + (de forma consistente dentro de una lista):
- Elemento uno
- Elemento dos
- Elemento tres
Resultado:
1. Primer elemento
2. Segundo elemento
3. Tercer elemento
Resultado:
✅ Los números se incrementan solos — usar
1.en cada elemento es válido y a menudo preferido.
Indenta los elementos anidados con 2 o 4 espacios (depende del visor; 4 es lo más seguro):
- Nivel 1
- Nivel 2
- Nivel 3
- Vuelta al nivel 1
1. Padre ordenado
1. Hijo ordenado
2. Otro hijo
- La anidación mixta también funciona
Resultado:
Sintaxis de casillas GFM:
- [x] Tarea completada
- [ ] Tarea pendiente
- [ ] Otra tarea
Resultado:
Prefija las líneas con >:
> Esto es una cita en bloque.
> Citas de varias líneas
> continúan con `>` en cada línea.
> Citas anidadas:
>> Segundo nivel
>>> Tercer nivel
Resultado:
Esto es una cita en bloque.
Citas de varias líneas continúan con
>en cada línea.
Citas anidadas:
Segundo nivel
Tercer nivel
Combina con otros elementos:
> **Nota:** Información importante aquí.
>
> - Punto uno
> - Punto dos
Resultado:
Nota: Información importante aquí.
- Punto uno
- Punto dos
Envuelve el texto en backticks simples:
Usa la función `printf()`.
Usa `` `backticks` `` dentro del código duplicando la cerca exterior.
Resultado:
Usa la función printf().
Usa backticks dentro del código duplicando la cerca exterior.
Usa triple backtick (o tildes) con una etiqueta de lenguaje opcional para resaltado de sintaxis:
```python
def saludar(nombre):
print(f"¡Hola, {nombre}!")
```
Resultado:
def saludar(nombre):
print(f"¡Hola, {nombre}!")
Alternativa con tildes:
~~~javascript
console.log("Hola");
~~~
Resultado:
console.log("Hola");
Anidar backticks: Usa más backticks en la cerca exterior que la secuencia más larga del interior — p. ej. envuelve un bloque
```en````para mostrar la sintaxis del delimitador literalmente. Como alternativa, usa~~~como delimitador exterior en lugar de backticks.
Tres o más -, * o _ en una línea sola:
---
***
___
Resultado:
✅ Rodéalos con líneas en blanco para un renderizado fiable.
Tablas con tuberías GFM:
| Columna A | Columna B | Columna C |
|-----------|-----------|-----------|
| Fila 1 | Dato | Dato |
| Fila 2 | Dato | Dato |
Resultado:
| Columna A | Columna B | Columna C |
|---|---|---|
| Fila 1 | Dato | Dato |
| Fila 2 | Dato | Dato |
Alineación con dos puntos en la fila separadora:
| Izquierda | Centro | Derecha |
|:----------|:------:|--------:|
| A | B | C |
Resultado:
| Izquierda | Centro | Derecha |
|---|---|---|
| A | B | C |
⚠️ Las tablas con tuberías son una extensión GFM — no están en el Markdown original.
Usa barra invertida \ antes de caracteres especiales para mostrarlos literalmente:
\*no itálica\*
\# no es un encabezado
\[no es un enlace\]
Resultado:
*no itálica*
# no es un encabezado
[no es un enlace]
Caracteres escapables habituales: \ ` * _ { } [ ] ( ) # + - . ! |
La mayoría de visores permiten HTML en línea junto con Markdown:
<br>
<hr>
<span class="general-text">Span con estilo</span>
<details>
<summary>Clic para expandir</summary>
Contenido oculto aquí.
</details>
Resultado:
⚠️ La compatibilidad varía según el visor. El Markdown dentro de bloques HTML a menudo no se parsea.
Compatible con muchos parsers extendidos (Pandoc, Obsidian, algunos SSG):
Aquí hay una afirmación con nota al pie.[^1]
[^1]: Este es el texto de la nota al pie al final del documento.
Resultado:
Aquí hay una afirmación con nota al pie.1
Notas al pie en línea (Pandoc):
Aquí hay una nota en línea.^[Esto aparece como nota al pie.]
Resultado:
Aquí hay una nota en línea.^[Esto aparece como nota al pie.]
- para desordenadas es lo habitual).Este es el texto de la nota al pie al final del documento. ↩