Lección 5

Vista previa y exportación HTML

Comprende la vista previa en vivo, fragmentos HTML sanitizados y cuándo copiar Markdown vs HTML.

Las herramientas Markdown suelen ofrecer dos salidas distintas:

  1. Vista previa renderizada para leer mientras escribes
  2. Exportación HTML para sistemas que necesitan fragmentos HTML

Están relacionadas, pero no son idénticas.

Qué muestra la vista previa en vivo

La vista previa en vivo parsea Markdown y renderiza contenido estructurado como encabezados, párrafos, listas y tablas. En herramientas de navegador, eso suele significar elementos HTML con estilo CSS.

La vista previa responde: «¿Este documento se lee bien?»

Qué proporciona la exportación HTML

La exportación HTML convierte Markdown en etiquetas como:

<h1>Title</h1>
<p>Paragraph text.</p>
<ul>
  <li>Item</li>
</ul>

Las buenas herramientas sanitizan el HTML y evitan promover bloques HTML en bruto a contenido activo.

La exportación HTML responde: «¿Qué fragmento puedo pegar en otro sistema?»

Cuándo copiar Markdown vs HTML

DestinoMejor elección
README o incidencia de GitHubFuente Markdown
Repo de docs con archivos .mdFuente Markdown
Campo rich-text de CMSFragmento HTML
Email o wiki internaFragmento HTML, a menudo con revisión
Discusión en revisión de códigoFuente Markdown

La mayoría de pipelines de publicación prefieren Markdown porque el destino aplica su propio tema.

Temas de vista previa vs exportación

El estilo de vista previa ayuda a escribir cómodamente, pero el HTML copiado normalmente no incluye el CSS del tema de vista previa salvo que la herramienta exporte HTML con estilo explícitamente. Eso es normal.

Conclusión clave

Usa la vista previa para validar estructura y legibilidad. Usa exportación HTML cuando el siguiente sistema necesite HTML semántico, no fuente Markdown.

La herramienta Vista previa Markdown / Markdown a HTML soporta ambas rutas: vista previa en vivo más copiar/descargar fragmentos HTML sanitizados.

Volver al resumen del curso