Guía básica de Markdown: formato de texto, listas, enlaces e imágenes
| Markdown |
Markdown es un lenguaje de marcado ligero que permite dar formato a textos de manera sencilla y rápida, sin necesidad de usar HTML. Es ideal para crear documentación, escribir artículos, README de proyectos o contenido para la web.
En esta guía aprenderás los fundamentos de Markdown: cómo aplicar formato al texto, crear listas, insertar enlaces e imágenes.
¿Qué es Markdown?
Markdown fue creado por John Gruber con el objetivo de que los textos sean fáciles de leer en su forma original (sin renderizar) y que al mismo tiempo puedan convertirse fácilmente a HTML.
Se usa ampliamente en plataformas como GitHub, Reddit, MkDocs, Notion, Obsidian y muchos editores de blogs.
Formato de texto en Markdown
Puedes aplicar formato a tu texto de varias formas:
| Estilo | Sintaxis | Ejemplo | Resultado |
|---|---|---|---|
| Negrita | **texto** |
**importante** |
importante |
| Cursiva | *texto* |
*énfasis* |
énfasis |
| Tachado | ~~texto~~ |
~~eliminado~~ |
~~eliminado~~ |
| Código en línea | `código` |
`print("Hola")` |
print("Hola") |
| Bloque de código | |
ver abajo | bloque con sintaxis de código |
Ejemplo de bloque de código:
def saludo():
print("Hola Markdown!")
Listas en Markdown
Puedes crear listas ordenadas o sin orden fácilmente:
Lista sin orden (viñetas)
Usa -, + o *:
- Manzanas
- Peras
- Plátanos
Resultado:
- Manzanas
- Peras
- Plátanos
Lista ordenada (numerada)
Usa números seguidos de punto:
1. Introducción
2. Desarrollo
3. Conclusión
Resultado:
- Introducción
- Desarrollo
- Conclusión
Enlaces en Markdown
Los enlaces se escriben con la siguiente sintaxis:
[Texto del enlace](https://ejemplo.com)
Ejemplo:
También puedes incluir un título opcional:
[Markdown Guide](https://www.markdownguide.org "Guía completa de Markdown")
Imágenes en Markdown
La sintaxis es muy similar a la de los enlaces, pero se agrega un signo de exclamación al inicio:
Ejemplo:
Consejos para escribir en Markdown
- Usa títulos jerárquicos con
#,##,###para estructurar el contenido. - Separa los párrafos con una línea en blanco.
- No olvides incluir texto alternativo en las imágenes para mejorar la accesibilidad y el SEO.
- Markdown es compatible con HTML básico, por lo que puedes usar etiquetas si lo necesitas.
Markdown es una herramienta poderosa y fácil de aprender para crear contenido claro y estructurado. Con solo unos pocos símbolos puedes formatear texto, crear listas, insertar enlaces e imágenes sin complicaciones.
Si estás empezando con documentación o creación de contenido web, dominar Markdown es un excelente primer paso.