Markdown: fundamentos y documentación técnica

Este curso está dirigido a perfiles técnicos sin experiencia previa en lenguajes de marcado que necesitan documentar proyectos, escribir READMEs o colaborar en entornos donde Markdown es estándar. A lo largo de las sesiones el participante aprenderá a reconocer y aplicar la sintaxis esencial de Markdown —encabezados, listas, énfasis, tablas, código, enlaces e imágenes— para producir documentos técnicos legibles y correctamente renderizados. Al finalizar, será capaz de construir un README básico funcional y de identificar y corregir los errores de sintaxis más comunes.

Al finalizar el curso, el participante será capaz de:

• Identificar los elementos de sintaxis Markdown a partir de un documento .md dado, etiquetando cada fragmento con su nombre correcto
• Describir la diferencia entre el código fuente Markdown y su resultado renderizado, señalando qué símbolo produce qué efecto visual
• Aplicar la sintaxis de encabezados H1–H3 para estructurar jerárquicamente una sección de documento con al menos tres niveles distintos
• Aplicar listas ordenadas y no ordenadas, incluyendo al menos un nivel de anidamiento, en un documento de instrucciones técnico
• Aplicar listas de tareas con casillas marcables (sintaxis GFM) en un documento de seguimiento, verificando su renderizado en GitHub
• Aplicar la sintaxis de tablas Markdown, con fila de encabezado y alineación explícita de al menos una columna, para presentar un conjunto de datos tabulados
• Aplicar el marcado de énfasis, citas en bloque y separadores horizontales sobre un documento técnico, distinguiendo cuándo cada recurso aporta significado y no solo decoración
• Ejecutar el marcado de fragmentos de código inline y bloques de código con especificación de lenguaje en una documentación de función
• Aplicar la inserción de enlaces e imágenes con rutas relativas en un README de proyecto de estructura fija
• Identificar y corregir al menos cuatro errores de sintaxis Markdown en un documento defectuoso
• Construir un README básico para un proyecto ficticio que incluya encabezado, descripción, lista de requisitos, bloque de instalación y enlace externo

1. Qué es Markdown y cómo funciona Concepto de lenguaje de marcado ligero, diferencia entre código fuente y renderizado, herramientas de previsualización (VS Code Live Preview, GitHub); elementos de sintaxis principales: encabezados, listas, énfasis, tablas, bloques de código
2. Estructura jerárquica del documento Sintaxis de encabezados H1–H3 y organización semántica de secciones; listas ordenadas y no ordenadas con anidamiento; listas de tareas con casillas marcables (GFM); separación de párrafos y espaciado correcto
3. Formato de texto y tablas Énfasis con negrita y cursiva, citas en bloque y separadores horizontales, y cuándo cada uno aporta significado; sintaxis de tablas con fila de encabezado, separador y alineación explícita de columnas
4. Código, enlaces e imágenes Código inline con backticks, bloques de código con triple backtick y especificación de lenguaje; inserción de enlaces internos y externos; imágenes con rutas relativas y texto alternativo
5. Corrección de errores y construcción de un README Diagnóstico de errores frecuentes: espaciado tras #, delimitadores incorrectos, anidamiento roto; lectura y corrección guiada de documentos defectuosos; construcción paso a paso de un README con todas las secciones esenciales

• VS Code (última versión estable) con extensión Markdown Preview Enhanced o equivalente
• Git instalado y cuenta en GitHub para visualizar el renderizado en plataforma
• Acceso a un terminal básico para operaciones de fichero

Ninguno requerido. Se recomienda familiaridad básica con editores de texto (VS Code u otro) y navegación de archivos en el sistema operativo. Es útil, aunque no imprescindible, haber visto un repositorio en GitHub alguna vez.