Volver al Blog
lunes, 17 de noviembre de 2025

Guía completa de Markdown: flujo exprés con Markdown2Image

Guía completa de Markdown: flujo exprés con Markdown2Image

Markdown es ideal para escribir documentación y materiales visuales con rapidez. Esta versión en español del cheat sheet adopta el flujo de Markdown2Image para que tus notas pasen a tarjetas, carruseles y guías internas sin retrabajo.

🎯 Destacados

  • Todo en un único archivo: encabezados, texto, tablas y medios listos para copiar/pegar
  • Ejemplos prácticos: cada bloque incluye un "así se usa" realista
  • Guía visual: recomendaciones de proporciones 16:9 y 4:5 para que nada se desborde
  • Checklist integrada: valida contenido y salida antes de publicar

📝 Formato de texto esencial

_itálica_ / **negrita** / ~~tachado~~
***negrita + itálica***
`código inline` y ```bloques multilínea```
> Las citas se encadenan con ">"

Nota de campo: Encierra comandos y rutas con backticks para que Markdown2Image mantenga el contraste correcto.

Formatos extendidos

==Resaltado== para llamadas de atención
<u>Subrayado</u> con etiquetas HTML
H~2~O / 10^3^ para subíndices y superíndices

🔗 Enlaces y referencias

[Enlace normal](https://example.com)
[Enlace con título](https://example.com "Tooltip")
[Correo](mailto:[email protected])
[Teléfono](tel:+34910000000)

[GitHub]: https://github.com "Repositorio"
El detalle vive en [GitHub]

TIP: En textos largos mueve todas las URL a referencia para traducir y versionar sin perder trazabilidad.

🖼️ Imágenes y medios

![Hero](hero.png "Laptop y código")
![Ancho fijo](flow.png =480x)
![Dos columnas](img-left.png){width="48%"}
![Zoom al clic](diagram.png){data-zoomable}
  • Escribe la leyenda justo después usando *Texto de la figura*
  • Sube imágenes ≥1200px para asegurar salida retina en Markdown2Image

📊 Estructura y organización

Listas

- Entrega principal
  - Subtarea
1. Preparar
2. Implementar
   1. API
   2. UI
- [x] Terminado / [ ] Pendiente

Lista de definiciones

Markdown
: Lenguaje ligero para estructurar texto

Markdown2Image
: Servicio que convierte Markdown en diapositivas/visualizaciones

Tablas

| Comando | Propósito | Nota |
| --- | --- | --- |
| `npm install` | Instalar dependencias | Verifica versión de Node |
| `pnpm build` | Compilar producción | Usa --filter para paquetes |

⚙️ Flujo recomendado

  1. Borrador en Obsidian o VS Code
  2. Localiza en post_translations manteniendo slug y SEO por idioma
  3. Valida con markdownlint + pruebas de estilo internas
  4. Convierte en Markdown2Image reutilizando plantillas
  5. Publica vía revisión Directus + webhook del sitio

🧪 Checklist de QA

  • Todos los bloques tienen resaltado de sintaxis
  • Las URLs usan HTTPS y funcionan
  • Las tablas respetan 3 columnas o menos
  • El SEO combina palabras clave en español aunque el slug sea en inglés
  • Probaste 16:9 y 4:5 dentro de Markdown2Image

🔚 Cierre

Una sintaxis coherente reduce errores al generar recursos visuales. Usa esta guía como base de plantillas y verás cómo la localización, el QA y la exportación se mantienen alineados entre equipos.

Guía completa de Markdown (español) | Markdown2Image | MarkdownToImage