La guía de Markdown para escritores
Markdown es el lenguaje de marcado ligero detrás de GitHub, Reddit, Discord, Noción, Obsidian, Substack, Ghost, e innumerables generadores estáticos. Esta es la hoja de trampa que puedes marcar — más dos convertidores gratis.
Si escribes en línea y no conoces Markdown, estás pasando más tiempo formateando que escribiendo. Markdown te permite expresar títulos, negritas, itálicas, listas, enlaces, código, bloques e imágenes usando ~6 símbolos simples — no menús, no barra de herramientas, ningún ratón. También es el formato universal de exportación/import entre cada herramienta de escritura moderna que vale la pena usar.
Esta guía es la hoja de trampa sintaxis, cuándo-a-utilizar-qué consejo, y enlaces a los dos convertidores libres que construimos para manejar las migraciones entre Markdown y HTML.
Hoja de referencia de sintaxis
Encabezamientos
# H1 (one per page — your title)
## H2 (main sections)
### H3 (subsections)
#### H4
##### H5
###### H6 (rarely needed)uno # por nivel de encabezado. Un solo espacio entre los hashes y el texto de encabezado. No utilice H1 dentro de un artículo — Markdown CMSes utiliza el título de post como H1 ya.
Negrita y cursiva
**bold**
*italic*
***bold and italic***
~~strikethrough~~ (GitHub-flavored only)uso ** para negrita __ — es más legible y funciona en cada sabor. * para cursiva encima _ por la misma razón.
Enlaces e imágenes
[Visible link text](https://example.com)
[Reference-style link][1]
[1]: https://example.comLos enlaces de estilo de referencia (la forma inferior) son útiles cuando la misma URL se utiliza varias veces en un documento largo.
Listas
- Unordered item
- Another item
- Nested item (2-space indent)
1. Ordered item
2. Second item
1. Nested ordered itemConsejo profesional: para listas ordenadas, puede escribir 1. para cada línea - la mayoría de procesadores auto-renumeración. Esto hace que la inserción / movimiento de los elementos mucho más fácil.
Código
`inline code` for a quick keyword
```
multi-line code block
```
```python
fenced code block with language
```El bloque vallado triple-backtick es universalmente compatible y le permite especificar el idioma para resaltar la sintaxis.
Citas en bloque y reglas horizontales
> This is a blockquote.
> Multi-line by repeating > on each line.
--- (three or more dashes = horizontal rule)Tablas (Markdown con sabor a GitHub)
| Header | Header |
|--------|--------|
| Cell | Cell |
| Cell | Cell |Las tablas no están en la marcación original, pero son universales en los sabores modernos (GitHub, Noción, Obsidian, cada generador estático).
Conversión entre Markdown y HTML
La mayoría de CMSes aceptan tanto Markdown o HTML, pero algunos lo obligan a uno. Los dos flujos de trabajo más comunes:
- ¿Necesitas HTML para un CMS solo HTML? Utilice nuestro Rebajas → Convertidor HTMLPegar el marcador, copiar el HTML, caer en su CMS.
- ¿Migrando contenido de un CMS HTML-únicamente en un sistema de marcado (Noción, Obsidian, GitHub, Hugo)? Utilice nuestro HTML → Convertidor de rebajas. Las rayas estilos, clases y ruido en línea - deja limpio Markdown.
Rebajas en todo el ecosistema
| Herramienta | Sabor a rebajas | Notas |
|---|---|---|
| Archivos LÉAME/Problemas de GitHub | Rebaja con sabor a GitHub (GFM) | Tablas, listas de tareas, enlaces automáticos. |
| Extensiones CommonMark + | Etiquetas de spoiler, super/subíndice | |
| Discordia / holgura | Subconjunto | Bold/italic/code/strikethrough/blockquote |
| noción | Extensiones de base de datos CommonMark + | Alternar bloques, llamadas |
| obsidiana | CommonMark + wikienlaces | [[wikilinks]], incrustaciones, frontmatter |
| Subpila / Fantasma | Marca común | Marca común estándar |
| Hugo / Jekyll / Once | CommonMark + frontmatter | Portada de YAML en la parte superior del archivo |
| iA Writer / Oso / Ulises | Marca común | Edición WYSIWYG |
Cuándo NO usar Markdown
Markdown es genial para la prosa y la estructura.
- Contenido visual/con mucho diseño. Si estás poniendo una página de revistas, usa una herramienta de diseño, no Markdown.
- Formas, encuestas, mesas complejas y contenidos de estilo. Markdown no puede expresar lo que HTML+CSS puede. Si necesita un control preciso sobre fuentes, colores, columnas o elementos interactivos, escriba HTML directamente.
- Notación matemática. Algunos procesadores admiten LaTeX dentro de Markdown (
$\\alpha$Para las matemáticas pesadas, una herramienta LaTeX-primer gana. - Datos altamente estructurados. Utilice JSON/YAML/TOML, no listas de Markdown.
Frontmatter: el arma secreta
La mayoría de los generadores estáticos soportan la primera máquina de YAML en la parte superior de cada archivo Markdown. Esto es metadatos sobre el post — título, fecha, etiquetas, autor— que el generador lee en el tiempo de construcción.
---
title: My First Blog Post
date: 2026-05-07
author: Jane Smith
tags: [writing, productivity]
---
# My First Blog Post
Body of the post in Markdown…Los diferentes generadores esperan diferentes teclas. Hugo utiliza title, date, draft; usos jekyll layout, title, permalink; Once usos permalink, tags, layout. Lea los documentos de su generador para obtener detalles.
Herramientas gratuitas utilizadas en esta guía.
- Rebajas → Convertidor HTML — convertir Markdown a HTML semántico limpio.
- HTML → Convertidor de rebajas — Extraer el marcador limpio de HTML renderizado, perfecto para la migración de contenidos.
- Buscar y reemplazar — útil para la conversión de lotes una variante de marcado a otra.
- Contador de palabras — el recuento de palabras y la puntuación de legibilidad de su borrador.
- Contador de caracteres — los datos de carácter para los tiempos Los documentos de marcado tienen límites difíciles (por ejemplo, las insignias de GitHub README).
Preguntas frecuentes
¿Cuál es la diferencia entre Markdown y CommonMark?
¿Es diferente el Markdown con sabor a GitHub?
- [x]), huelga y autovínculo. La mayoría de los CMSes modernos siguen GFM en lugar de estricto CommonMark, así que cuando en duda, escriba GFM.