Qué es Markdown: guía completa para principiantes
Markdown es una sintaxis ligera de formato sobre texto plano creada por John Gruber en 2004. Escribes documentos con formato usando símbolos sencillos y legibles — # para los títulos o **negrita** para el texto en negrita — sin tocar HTML.
Hoy Markdown lo usan millones de desarrolladores, autores, estudiantes y blogueros. Es la sintaxis por defecto en GitHub, Reddit, Stack Overflow, Discord, Slack y muchas otras plataformas.
¿Qué es un archivo .md?
Un archivo .md es un archivo de texto plano que contiene sintaxis Markdown. La extensión viene de "Markdown". También verás .markdown, aunque .md es mucho más habitual.
Como son texto plano, puedes abrirlos con cualquier editor de texto — Notepad, TextEdit, VS Code o incluso el navegador. El formato solo se ve cuando lo renderiza una aplicación que entiende Markdown.
¿Por qué se creó Markdown?
John Gruber lo diseñó con un objetivo: que se pudiera leer como texto plano. A diferencia de HTML o LaTeX, un documento Markdown se entiende perfectamente sin renderizar:
## Versión HTML
<h2>Mi título</h2>
<p>Esto es una palabra en <strong>negrita</strong>.</p>
## Versión Markdown
## Mi título
Esto es una palabra en **negrita**.
Ambas versiones producen el mismo resultado, pero la fuente en Markdown se lee al instante.
¿Quién usa Markdown?
- Desarrolladores — archivos README, documentación, comentarios de código
- Redactores técnicos — documentación de API, manuales, wikis
- Blogueros — entradas en Ghost, WordPress, Jekyll
- Estudiantes — apuntes, trabajos, presentaciones
- Científicos de datos — cuadernos de Jupyter, informes en R Markdown
- Gestores de proyecto — incidencias de GitHub/GitLab, páginas de Confluence
¿Dónde se utiliza Markdown?
- GitHub / GitLab — README, issues, pull requests, wikis
- Stack Overflow — preguntas y respuestas
- Reddit — formato de los comentarios
- Discord / Slack — formato de los mensajes
- Notion / Obsidian / Bear — toma de notas
- Ghost / Jekyll / Hugo — generadores de sitios estáticos y blogs
- VS Code / Atom — documentación y vista previa
Sintaxis básica de Markdown
Títulos
# Título 1
## Título 2
### Título 3
Negrita y cursiva
**negrita**
*cursiva*
***negrita y cursiva***
Listas
- Punto
- Otro punto
1. Primer elemento
2. Segundo elemento
Enlaces e imágenes
[texto del enlace](https://example.com)
Código
Código `en línea` entre acentos graves.
```javascript
// Bloque de código con resaltado de sintaxis
console.log("Hello, Markdown!");
### Citas y tablas
Esto es una cita.
| Columna 1 | Columna 2 |
|---|---|
| Celda 1 | Celda 2 |
## Dialectos de Markdown
Existen varias variantes — **GFM** (GitHub Flavored Markdown) es la más extendida, con tablas, listas de tareas y bloques de código con vallas.
## Preguntas frecuentes
### ¿Markdown es lo mismo que HTML?
No. Markdown es mucho más sencillo. Markdown usa `**negrita**`; HTML, `<strong>negrita</strong>`. Markdown está pensado para la legibilidad y HTML para la estructura web.
### ¿Puedo usar Markdown en documentos profesionales?
Sí. Muchas empresas documentan oficialmente en Markdown y luego exportan a PDF o Word.
### ¿Markdown es gratis?
Sí, Markdown es libre y de código abierto. La sintaxis y buena parte de los editores no cuestan nada.
### ¿Cuál es la diferencia entre .md y .txt?
Ambos son texto plano. `.md` usa sintaxis Markdown y `.txt` no tiene ningún formato.
## Siguientes pasos
1. Convertir: [Markdown → PDF](/markdown-to-pdf)
2. Detalles de la sintaxis: [Guía de sintaxis de Markdown](/blog/markdown-syntax-guide)
3. Para consultar: [Chuleta de Markdown](/blog/markdown-cheat-sheet)