====== 03 - Markdown ======

**Markdown** es un lenguaje de marcas ligero para escribir texto con formato desde un editor cualquiera. Se usa en ''README.md'', documentación técnica, PR de GitHub y ficheros como ''AGENTS.md''.

===== 1. Sintaxis =====

<sxh markdown>
# Título 1
## Título 2
### Título 3

Párrafo normal. **negrita**, *cursiva*, `código en línea`.

- Elemento de lista
- Otro elemento
  - Subelemento

1. Primer paso
2. Segundo paso

[Enlace](https://example.com)
![Texto alternativo de imagen](captura.png)

> Cita o nota destacada
</sxh>

^ Elemento ^ Sintaxis ^
| Encabezados | ''#'', ''##'', ''###'' (jerarquía) |
| Negrita / cursiva | ''**texto**'' / ''*texto*'' |
| Código en línea | ''``texto``'' |
| Lista sin orden | ''-'' o ''*'' |
| Lista numerada | ''1.'', ''2.'' |
| Enlace | ''[texto](url)'' |
| Imagen | ''![alt](ruta)'' |
| Cita | ''>'' al inicio |

===== 2. Bloques de código =====

Las triples comillas delimitan bloques de código, con el lenguaje para resaltar la sintaxis:

<sxh markdown>
```java
public class Main {
    public static void main(String[] args) { }
}
```

```bash
mvn test
```
</sxh>

===== 3. Tablas =====

<sxh markdown>
| Comando | Acción |
|---------|--------|
| `git status` | Estado de los archivos |
| `git log --oneline` | Historial resumido |
</sxh>

===== 4. Usos habituales =====

  * **README.md:** presentación de un repositorio: qué es, cómo compilar, cómo ejecutar pruebas.
  * **AGENTS.md:** instrucciones para herramientas de IA en un proyecto.
  * **PR y issues:** descripción de cambios, con formato.
  * **Documentación:** guías y apuntes técnicos.

<note tip>Markdown se convierte a HTML para su presentación. Escribir títulos jerárquicos correctos (''#'', luego ''##''...) importa tanto en Markdown como en HTML: define la estructura del documento.</note>