Markdown es una forma de escribir texto con formato usando solo texto plano. Unos pocos símbolos se convierten en encabezados, listas, enlaces y código, y el resultado se convierte a HTML. Lo usan GitHub, los archivos README, los sitios de documentación, los foros y las aplicaciones de notas. Previsualice el suyo en el Visualizador de Markdown. Cada fila de abajo se renderizó con un procesador de Markdown para confirmar que funciona.
Lo básico
| Escribe | Obtiene |
|---|---|
# Heading 1<br>## Heading 2 |
Encabezados: de uno a seis signos # |
bold |
Negrita |
italic |
Cursiva |
text |
Enlace |
|
Imagen (el texto entre corchetes es el texto alternativo) |
- item<br>- item |
Lista con viñetas (-, * o +) |
1. first<br>2. second |
Lista numerada |
> quoted |
Cita en bloque |
`code` |
Código en línea |
```<br>code block<br>``` |
Bloque de código delimitado (añada un lenguaje tras la primera valla para resaltar) |
--- |
Línea horizontal |
| a | b |<br>|---|---|<br>| 1 | 2 | |
Tabla (una extensión en algunos procesadores; la admiten la mayoría) |
Consejos
- Deje una línea en blanco entre párrafos, antes de las listas y alrededor de los bloques de código.
- Termine una línea con dos espacios (o una barra invertida en algunos procesadores) para un salto de línea sin nuevo párrafo.
- Sangre un elemento de lista anidado con dos a cuatro espacios.
- Escape un símbolo con una barra invertida para mostrarlo literalmente, como en
\*no cursiva\*. - El HTML en bruto suele funcionar dentro de Markdown, pero algunos sitios lo eliminan por seguridad.
Los dialectos difieren
El Markdown original es pequeño. La mayoría de las plataformas añaden extensiones: GitHub Flavored Markdown añade tablas, listas de tareas (- [ ] tarea), tachado (~~texto~~) y enlaces automáticos; otras añaden notas al pie, listas de definiciones o matemáticas. Si algo no se renderiza, compruebe qué dialecto usa el sitio.
Convertir
Convierta Markdown a HTML con cualquier procesador, y al revés con el Conversor de HTML a Markdown o el CSV a Tabla Markdown para tablas.