Lección 6
Flujo de escritura Markdown
Revisa estructura de encabezados, enlaces, tablas y errores habituales de Markdown antes de publicar.
Antes de publicar Markdown en GitHub, un repo de docs o un campo CMS, haz una pasada corta de revisión.
Un flujo práctico
- Redacta el documento en Markdown.
- Previsualiza la salida renderizada.
- Comprueba el esquema de encabezados por niveles omitidos o secciones faltantes.
- Revisa la lista de enlaces por URLs rotas o de marcador de posición.
- Verifica que tablas, bloques de código y listas de tareas se rendericen correctamente.
- Copia Markdown para destinos basados en Git, o copia HTML para rutas CMS/email.
Errores habituales de Markdown
- Niveles de encabezado omitidos: saltar de
#a###sin un## - Listas rotas: líneas en blanco faltantes antes de listas en algunos renderizadores
- Bloques de código delimitados sin cerrar: olvidar los backticks de cierre
- Ruido de alineación en tablas: filas con recuentos de columna inconsistentes
- Enlaces de marcador de posición: dejar
https://example.comen docs finales - Uso excesivo de HTML: depender de HTML en bruto cuando la sintaxis Markdown sería más clara
Las comprobaciones de estructura importan más que el estilo
La calidad de Markdown depende sobre todo de:
- encabezados fáciles de escanear
- párrafos cortos
- enlaces explícitos
- muestras de código que funcionen
- tablas que coincidan con la forma de los datos
Los colores del tema de vista previa no viajan con el documento. La estructura sí.
Conclusión clave
Trata la revisión de Markdown como un paso ligero de QA de documentación: vista previa, inspecciona estructura, valida enlaces y elige el formato de exportación correcto para el destino.
La herramienta Vista previa Markdown / Markdown a HTML soporta este flujo con vista previa en vivo, esquema de encabezados, lista de enlaces y acciones de copiar en un solo espacio de trabajo.