Sistemas informáticos

Appearance

A4. Markdown ​

En esta actividad se creará un documento que servirá como plantilla de referencia de Markdown para las prácticas del módulo.

El documento mostrará diferentes elementos que pueden utilizarse en Markdown y permitirá consultar rápidamente su sintaxis y el resultado que producen.

Para cada característica se incluirán:

  • Una breve descripción.
  • El código Markdown utilizado.
  • Una captura de pantalla de su resultado en la previsualización de Visual Studio Code.

Previsualización

Utiliza la previsualización de Markdown de Visual Studio Code para comprobar el resultado mientras editas el documento.

Puedes abrirla mediante:

text
Ctrl + Shift + V

1. Preparación ​

Utiliza como documento de esta actividad el archivo:

text
ud1-a4-markdown/index.md

Las capturas de pantalla se almacenarán en:

text
ud1-a4-markdown/images/

Abre index.md con Visual Studio Code y mantén visible la previsualización mientras realizas la actividad.

2. Encabezados ​

Documenta cómo crear los diferentes niveles de encabezado disponibles en Markdown.

Incluye ejemplos de los niveles:

text
#
##
###
####
#####
######

Muestra el código utilizado y una captura con el resultado.

Explica brevemente por qué los encabezados deben utilizarse siguiendo una estructura jerárquica y no simplemente por su tamaño visual.

3. Párrafos ​

Documenta cómo escribir y separar diferentes párrafos.

Crea un ejemplo que contenga al menos dos párrafos.

Muestra:

  • El código Markdown.
  • El resultado obtenido.

4. Formato de texto ​

Documenta mediante ejemplos cómo escribir:

  • Texto en negrita.
  • Texto en cursiva.
  • Texto en negrita y cursiva.
  • Texto tachado.

Para cada posibilidad muestra el código Markdown correspondiente y su resultado.

5. Listas ​

Documenta los diferentes tipos de listas que pueden utilizarse.

Incluye ejemplos de:

  • Lista no ordenada.
  • Lista ordenada.
  • Lista anidada.
  • Lista de tareas.

La lista de tareas deberá contener elementos marcados y sin marcar.

Muestra el código Markdown utilizado y el resultado obtenido.

6. Enlaces ​

Documenta cómo crear un enlace.

Incluye un ejemplo que enlace a una página de documentación oficial utilizada durante el módulo.

Utiliza como texto del enlace una descripción del recurso y evita expresiones como:

text
Haz clic aquí

Muestra el código Markdown y su resultado.

7. Imágenes ​

Documenta cómo insertar una imagen almacenada dentro del propio proyecto.

Utiliza una de las capturas realizadas durante esta actividad y guárdala dentro del directorio:

text
images/

Inserta la imagen utilizando una ruta relativa.

Muestra el código Markdown utilizado y su resultado.

Explica brevemente para qué sirve el texto alternativo de una imagen.

8. Citas ​

Documenta cómo crear una cita en Markdown.

Incluye:

  • Una cita sencilla.
  • Una cita formada por varias líneas.

Muestra el código Markdown y su resultado.

9. Código en línea ​

Documenta cómo incluir código dentro de una frase.

Crea ejemplos que incluyan:

  • Un comando.
  • Un nombre de archivo.
  • Una ruta.

Muestra el código Markdown utilizado y su resultado.

10. Bloques de código ​

Documenta cómo crear bloques de código.

Incluye al menos:

  • Un bloque Bash.
  • Un bloque JavaScript.
  • Un bloque de texto sin formato.

Comprueba el efecto de indicar el lenguaje después de los caracteres utilizados para abrir el bloque.

Muestra el código Markdown y una captura en la que pueda observarse el resultado.

11. Tablas ​

Crea una tabla Markdown que contenga al menos:

  • Tres columnas.
  • Una fila de encabezados.
  • Tres filas de datos.

Utiliza información relacionada con las herramientas empleadas durante el módulo.

Muestra el código Markdown y su resultado.

12. Línea horizontal ​

Documenta cómo crear una línea horizontal en Markdown.

Incluye el código necesario y muestra su resultado.

13. Caracteres especiales ​

Algunos caracteres tienen un significado especial dentro de Markdown.

Investiga cómo mostrar literalmente alguno de estos caracteres cuando Markdown intenta interpretarlos como parte de su sintaxis.

Utiliza al menos tres caracteres diferentes y muestra:

  • El problema encontrado.
  • El código utilizado para solucionarlo.
  • El resultado obtenido.

14. Plantilla final ​

Revisa el documento completo y comprueba que puede utilizarse como referencia rápida de Markdown en futuras prácticas.

El documento deberá tener una estructura clara y permitir localizar fácilmente cómo se realiza cada elemento.

Para cada característica debe aparecer, como mínimo:

  1. El nombre de la característica.
  2. Una breve descripción.
  3. El código Markdown.
  4. Una captura del resultado.

Código y resultado

El objetivo de la actividad no es únicamente mostrar cómo queda un elemento.

Debe poder verse también qué código Markdown es necesario escribir para obtener ese resultado.

Referencias ​

Añade las fuentes utilizadas para consultar la sintaxis de Markdown.

Utiliza preferentemente documentación de referencia como:

Ten en cuenta que algunas características pueden depender de la implementación de Markdown utilizada.