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, 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
• 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; separación de párrafos y espaciado correcto
3. 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
4. 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.