Markdown es una forma sencilla de formatear texto usando caracteres simples. Se usa en todas partes — GitHub, Reddit, Notion, Discord, documentación técnica y un sinfín de otras plataformas. En lugar de hacer clic en botones para poner texto en negrita o crear encabezados, escribes símbolos simples. Este tutorial te enseña lo esencial y te permite practicar usando nuestra herramienta gratuita Vista previa de Markdown.
Lo que necesitas
- Un navegador web (Chrome, Firefox, Safari o Edge)
- Sin cuenta ni instalación necesaria
- Unos 10 minutos para aprender lo básico
Guía paso a paso
Abre la herramienta Vista previa de Markdown
Ve a la herramienta Vista previa de Markdown. Verás un editor de pantalla dividida: el lado izquierdo es donde escribes Markdown, y el lado derecho muestra la vista previa formateada en tiempo real. Cada cambio que escribes aparece instantáneamente en la vista previa.
Aprende la sintaxis básica
Empieza a escribir en el editor para experimentar con el formato Markdown. La sintaxis principal es simple y se puede aprender en minutos. Practica con los ejemplos de abajo — escríbelos en el lado izquierdo y observa el resultado formateado aparecer a la derecha.
Escribe tu documento
Ahora escribe tu contenido real. Usa encabezados para estructurar tu documento, listas para organizar información, y texto en negrita o cursiva para dar énfasis. La vista previa en tiempo real asegura que siempre sepas cómo se verá el resultado final mientras escribes.
Exporta o copia el resultado
Una vez que tu documento se vea como quieres, copia el texto Markdown para usarlo en cualquier plataforma que lo soporte, o exporta el resultado formateado. Tu contenido Markdown se puede pegar en GitHub, Reddit, Notion o cualquier editor compatible con Markdown.
Para tu información Markdown fue diseñado para ser legible incluso sin renderizar. Un documento Markdown se ve limpio y estructurado como texto plano, que es una de las razones por las que se hizo tan popular.
Sintaxis esencial de Markdown
Encabezados
Usa símbolos # para crear encabezados. Más símbolos # significan encabezados más pequeños:
# Encabezado 1 (el más grande)
## Encabezado 2
### Encabezado 3
#### Encabezado 4
Texto en negrita y cursiva
Envuelve el texto con asteriscos para dar énfasis:
**Esto es texto en negrita**
*Esto es texto en cursiva*
***Esto es negrita y cursiva***
Listas
Crea listas desordenadas con guiones y listas ordenadas con números:
- Primer elemento
- Segundo elemento
- Tercer elemento
1. Paso uno
2. Paso dos
3. Paso tres
Enlaces
Crea enlaces clicables usando corchetes y paréntesis:
[Texto del enlace](https://example.com)
Código
Usa acentos graves para código en línea y triple acento grave para bloques de código:
En línea: `console.log("hello")`
Bloque de código:
```javascript
function greet(name) {
return "Hello, " + name;
}
```
Consejo No necesitas memorizar todo de una vez. Empieza con encabezados, negrita y listas — esos tres cubren el 80% de la escritura típica en Markdown. Añade más sintaxis a medida que la necesites.
Imágenes
Añade imágenes con un signo de exclamación antes de la sintaxis de enlace:
Citas
Usa > para crear texto citado:
> Esto es una cita.
> Puede abarcar varias líneas.
Dónde se usa Markdown
| Plataforma | Cómo se usa Markdown |
|---|---|
| GitHub | Archivos README, issues, pull requests, comentarios |
| Formato de publicaciones y comentarios | |
| Notion | Contenido de páginas y documentación |
| Discord | Formato de mensajes |
| Stack Overflow | Preguntas, respuestas y comentarios |
| Generadores de sitios estáticos | Publicaciones de blog y contenido de páginas |
Importante Diferentes plataformas soportan características de Markdown ligeramente diferentes. Lo básico (encabezados, negrita, cursiva, listas, enlaces) funciona en todas partes. Las características avanzadas como tablas o notas al pie varían según la plataforma. Siempre previsualiza antes de publicar en una nueva plataforma.
Preguntas frecuentes
¿Cuál es la diferencia entre Markdown y HTML? Markdown se convierte a HTML entre bastidores. Es una forma más simple de escribir texto formateado sin recordar etiquetas HTML. Cualquier lugar que acepte Markdown lo renderizará como HTML.
¿Puedo usar Markdown para documentos profesionales? Por supuesto. Muchos equipos usan Markdown para documentación, propuestas e informes. Existen herramientas para convertir Markdown a PDF, Word y formatos de presentación.
¿La sintaxis es la misma en todas partes? La sintaxis principal es universal. Algunas plataformas añaden extensiones (como GitHub Flavored Markdown que añade tablas y listas de tareas). Lo básico cubierto en este tutorial funciona en todas partes.
Próximos pasos
Ahora que conoces Markdown, prueba a escribir un README para un proyecto, formatear una publicación de blog o crear documentación técnica. Para tareas de formato más avanzadas, explora nuestro Formateador JSON para documentación de código o el Editor de PDF para la salida final de documentos.