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
# 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)  > Cita o nota destacada
| 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 |  |
| Cita | > al inicio |
2. Bloques de código
Las triples comillas delimitan bloques de código, con el lenguaje para resaltar la sintaxis:
```java
public class Main {
public static void main(String[] args) { }
}
```
```bash
mvn test
```
3. Tablas
| Comando | Acción | |---------|--------| | `git status` | Estado de los archivos | | `git log --oneline` | Historial resumido |
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.
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.