Guia de Markdown para principiantes: sintaxis completa con ejemplos y editor gratis
Aprende Markdown desde cero. Titulos, listas, enlaces, imagenes, tablas, codigo y mas. Editor online gratuito con previsualizacion en vivo.
Que es Markdown y por que usarlo
Markdown es un lenguaje de marcado ligero creado por John Gruber y Aaron Swartz en 2004. Permite formatear texto plano con una sintaxis simple que se convierte a HTML.
Donde se usa Markdown en 2026:
- GitHub: README.md, issues, pull requests, wikis — todo es Markdown.
- Documentacion: Docusaurus, MkDocs, Gitbook, Notion — todos usan Markdown.
- Blogs: Jekyll, Hugo, Next.js MDX — articulos en Markdown.
- Notas: Obsidian, Logseq, Bear — notes apps basadas en Markdown.
- Mensajeria: Slack, Discord, Reddit, WhatsApp (limitado) soportan subsets de Markdown.
Practica Markdown con el editor Markdown de NexTools que tiene previsualizacion en vivo.
Sintaxis basica: titulos, parrafos, enfasis
Titulos:
# Titulo H1
## Titulo H2
### Titulo H3
#### Titulo H4
Parrafos: Texto normal. Dos saltos de linea = nuevo parrafo. Un salto = mismo parrafo (en muchos renders).
Enfasis:
*italica*o_italica_→ italica**negrita**o__negrita__→ negrita***negrita italica***→ negrita italica~~tachado~~→tachado(GitHub Flavored Markdown)
Listas, enlaces e imagenes
Lista desordenada:
- Item 1
- Item 2
- Sub-item 2.1
Lista ordenada:
1. Primero
2. Segundo
3. Tercero
Enlaces:
[Texto del enlace](https://ejemplo.com)
Imagenes:
Enlace con imagen:
[](https://enlace.com)
Si necesitas generar URLs amigables para tus enlaces, usa el generador de slug de NexTools.
Codigo, bloques de codigo y tablas
Codigo inline: Usa backticks: `variable` → variable
Bloque de codigo:
```javascript
function hello() {
console.log("Hello");
}
```
Tablas (GFM):
| Columna 1 | Columna 2 |
|-----------|-----------|
| Celda 1 | Celda 2 |
Alineacion:
| Izquierda | Centro | Derecha |
|:----------|:------:|--------:|
Para verificar JSON en tus bloques de codigo, usa el validador JSON de NexTools.
Elementos avanzados: citas, lineas, checklist
Citas:
> Esta es una cita.
> Puede tener multiples lineas.
Linea horizontal:
--- o *** o ___
Checklist (GFM):
- [x] Tarea completada
- [ ] Tarea pendiente
Notas al pie (Extended):
Texto con nota[^1].
[^1]: Esta es la nota al pie.
HTML dentro de Markdown:
La mayoria de renders permiten HTML directo: <details><summary>Click</summary>Contenido oculto</details>
Markdown flavors: CommonMark, GFM, MDX
CommonMark: Especificacion estandar de Markdown. Define las reglas exactas para evitar ambiguedades.
GFM (GitHub Flavored Markdown): Extiende CommonMark con tablas, checklist, tachado, autolinks y bloques de codigo con lenguaje.
MDX: Markdown + JSX. Permite importar y usar componentes React dentro del Markdown. Usado en Next.js, Docusaurus, Storybook.
R Markdown: Markdown + codigo R ejecutable. Para data science y reportes estadisticos.
Obsidian Markdown: Extiende con wikilinks ([[pagina]]), callouts y metadatos YAML.
Editor Markdown de NexTools: previsualizacion en vivo
El editor Markdown de NexTools:
- Escribe Markdown a la izquierda, ve el HTML renderizado a la derecha
- Syntax highlighting para facilitar la escritura
- Soporta GFM (tablas, checklist, tachado)
- Copia el HTML resultante para pegar en emails, CMS o blogs
- Todo en el navegador, sin enviar datos
Para contar las palabras de tu documento Markdown, usa el contador de palabras de NexTools.
Mejores practicas para escribir Markdown
1. Un titulo H1 por documento. Equivale al <h1> en HTML. Multiple H1s confunden a SEO y accesibilidad.
2. Salto de linea entre elementos. Deja una linea en blanco entre parrafos, listas y bloques de codigo. Mejora la legibilidad del fuente y evita errores de renderizado.
3. Usa listas para mas de 2 items. En vez de "Necesitas X, Y y Z", usa una lista con bullets.
4. Texto alternativo en imagenes. Siempre llena el alt: . Es accesibilidad y SEO.
5. Codigo con lenguaje especificado. Usa ```python en vez de solo ```. Activa syntax highlighting y mejora la legibilidad.
6. Evita HTML innecesario. Si Markdown puede hacerlo, usalo. HTML dentro de Markdown reduce la portabilidad.
Prueba esta herramienta:
Abrir herramienta→Preguntas frecuentes
Markdown y HTML son lo mismo
No. Markdown es una sintaxis simplificada que se CONVIERTE a HTML. Escribes # Titulo y se convierte a <h1>Titulo</h1>. Markdown es mas facil de escribir y leer; HTML es mas poderoso y flexible. Puedes mezclar ambos en la mayoria de renders.
Donde puedo usar Markdown
GitHub (README, issues, PRs), documentacion (Docusaurus, MkDocs), blogs (Jekyll, Hugo, Next.js), notas (Obsidian, Notion), messaging (Slack, Discord, Reddit). Es el formato mas universal para texto formateado entre desarrolladores.
Que es GFM (GitHub Flavored Markdown)
Una extension de Markdown estandar creada por GitHub. Agrega tablas, checklist, tachado (~~texto~~), autolinks, y bloques de codigo con lenguaje. Es el flavor mas usado en desarrollo.
Puedo usar Markdown para documentos complejos como Word
Para documentos simples-medios, si. Para documentos con layout complejo (columnas, headers/footers, indices), necesitas herramientas adicionales: Pandoc convierte Markdown a Word/PDF con templates. MDX permite componentes custom.
Como pongo una imagen en Markdown
Sintaxis: . Para imagenes locales, usa ruta relativa: . Para imagenes web: .
Markdown soporta colores o estilos CSS
No nativamente. Markdown puro no tiene sintaxis de color. Puedes usar HTML inline (<span style='color:red'>texto</span>) en renders que lo soporten, pero esto reduce la portabilidad del Markdown.