Markdown - lenguaje de marcado

Markdown - lenguaje de marcado#

Trabajo previo#

Instalación de software#

Instale el editor de código fuente Visual Studio Code.

Tutoriales#

Markdown Tutorial. (s.f.). Recuperado el 1 de marzo de 2024, de https://www.markdowntutorial.com/

Otros#

Cree una cuenta gratuita en la plataforma de desarrollo colaborativo GitHub.

Introducción#

Markdown es un lenguaje de marcado, creado en 2004 por John Gruber y Aaron Swartz. Las “marcas” se utilizan para especificar aspectos de la estructura (ej. títulos, encabezados), estilo (ej. negritas, itálicas) y semántica de un documento. Markdown se caracteriza por ser más sencillo de leer y de usar que otros lenguajes de marcado (ej. Lenguaje de Marcado de Hipertexto o HTML), por lo que se considera un lenguaje de marcado ligero.

Los documentos escritos en Markdown pueden exportarse a una gran variedad de formatos (ej. HTML, DOC, PDF, LaTex) para ser usados en libros, presentaciones o páginas web, entre otros.

Las variaciones de Markdown, también llamadas flavors, son extensiones o modificaciones de la especificación original. Entre las más populares están:

Python Markdown: para el lenguaje Python.
GitHub Flavored Markdown: para la plataforma GitHub.
Pandoc’s Markdown: para el programa Pandoc de conversión entre formatos.
Quarto: más que un flavor de Markdown es un sistema de publicación de documentos técnicos y científicos que utiliza Markdown. Tiene soporte para incluir y ejecutar código en R, Python, Julia y Observable.

Puede encontrarse una lista más extensa de variaciones de Markdown en Markdown Flavors.

Ejemplo de documento#

El siguiente es un ejemplo de la sintaxis de Markdown, con marcas para un encabezado, texto en negrita, texto en itálica, un hipervínculo y una imagen.

### Los satélites galileanos

Se llaman **satélites galileanos** los cuatro satélites
de Júpiter descubiertos en 1610 por 
[Galileo Galilei](https://es.wikipedia.org/wiki/Galileo_Galilei): 
*Ío*, *Europa*, *Ganimedes* y *Calisto*. 
Son los más grandes de los satélites de Júpiter, 
siendo visibles incluso con telescopios de baja potencia.

![Imagen de Júpiter y los satélites](https://upload.wikimedia.org/wikipedia/commons/thumb/f/fe/Jupiter_and_the_Galilean_Satellites.jpg/168px-Jupiter_and_the_Galilean_Satellites.jpg)

**Figura 1**. Los cuatro satélites galileanos, 
en una composición que compara sus tamaños con el tamaño de Júpiter. 
En orden descendente, son *Ío*, *Europa*, *Ganimedes* y *Calisto*.

El documento se visualiza de la siguiente manera:

Los satélites galileanos#

Se llaman satélites galileanos los cuatro satélites de Júpiter descubiertos en 1610 por Galileo Galilei: Ío, Europa, Ganimedes y Calisto. Son los más grandes de los satélites de Júpiter, siendo visibles incluso con telescopios de baja potencia.

Figura 1. Los cuatro satélites galileanos, en una composición que compara sus tamaños con el tamaño de Júpiter. En orden descendente, son Ío, Europa, Ganimedes y Calisto.

El contenido de este ejemplo está basado en Satélite galileano - Wikipedia, la enciclopedia libre.

Sintaxis#

En esta sección, se explican los principales elementos de sintaxis de Markdown y se muestran sus salidas.

Encabezados#

Hay seis niveles de encabezados en Markdown, siendo el nivel 1 el de letras más grandes y el 6 el de letras más pequeñas. Se especifican mediante símbolos de numeral (#) antes del texto del encabezado (note el espacio entre el último signo de numeral y el inicio del texto).

Sintaxis Markdown	Salida
# Encabezado de nivel 1	Encabezado de nivel 1
## Encabezado de nivel 2	Encabezado de nivel 2
### Encabezado de nivel 3	Encabezado de nivel 3
#### Encabezado de nivel 4	Encabezado de nivel 4
##### Encabezado de nivel 5	Encabezado de nivel 5
###### Encabezado de nivel 6	Encabezado de nivel 6

Para los encabezados de nivel 1 y nivel 2, existe una sintaxis alterna, con símbolos de igual (=====) o guiones (-----) bajo el texto del encabezado.

Sintaxis Markdown	Salida
Otro encabezado de nivel 1 ==========================	Otro encabezado de nivel 1
Otro encabezado de nivel 2 --------------------------	Otro encabezado de nivel 2

Párrafos#

Los párrafos deben separarse mediante (al menos) una línea en blanco. Un simple cambio de línea no generará un nuevo párrafo.

Sintaxis Markdown

Salida

Este es el texto que corresponde al primer párrafo de un documento.

Este es el texto que corresponde al segundo párrafo de un documento.

Este es el texto que corresponde al primer párrafo de un documento.

Este es el texto que corresponde al segundo párrafo de un documento.

Negrita#

Hay dos sintaxis para especificar texto en negrita: con dos asteriscos (**) o con dos guiones bajos (__), antes y después del texto.

Sintaxis Markdown	Salida
Texto en negrita	Texto en negrita
__Otro texto en negrita__	Otro texto en negrita

Itálica#

Hay dos sintaxis para especificar texto en itálica: con un asterisco (*) o con un guión bajo (_), antes y después del texto.

Sintaxis Markdown	Salida
Texto en itálica	Texto en itálica
_Otro texto en itálica_	Otro texto en itálica

Citas textuales#

Se especifican con un símbolo de “mayor que” (>) antes de cada línea.

Sintaxis Markdown	Salida
> And on the pedestal these words appear: > "My name is Ozymandias, king of kings: > Look on my works, ye Mighty, and despair!" Percy Bysshe Shelley, "Ozymandias" (1818)	"And on the pedestal these words appear: "My name is Ozymandias, king of kings: Look on my works, ye Mighty, and despair!" Percy Bysshe Shelley, "Ozymandias" (1818)

Enlaces (hipervínculos)#

Se definen con paréntesis cuadrados ([]) seguidos de paréntesis redondos (()). En los paréntesis cuadrados se coloca (opcionalmente) el texto del enlace y en los redondos la dirección del documento al que conduce el enlace.

Sintaxis Markdown	Salida
[Proyecto Gutenberg](https://www.gutenberg.org/)	Proyecto Gutenberg

Imágenes#

Se definen con un signo de admiración de cierre (!), paréntesis cuadrados ([]) y paréntesis redondos (()). En los paréntesis cuadrados se coloca (opcionalmente) un texto alternativo de la imagen y en los redondos la dirección de la imagen, ya sea local o remota. Una imagen local se encuentra en la misma computadora en la que está el documento Markdown que la referencia, mientras que una imagen remota se encuentra en otra computadora a la que se accede mediante un protocolo de redes como el Protocolo de transferencia de hipertexto (HTTP).

Sintaxis Markdown	Salida
![Imagen local](img/maquina-turing.png)
![Imagen remota](https://upload.wikimedia.org/wikipedia/commons/thumb/b/b7/Turing_Machine.png/640px-Turing_Machine.png)

Markdown no cuenta con sintaxis para especificar el tamaño de una imagen, pero esto puede lograrse con el Lenguaje de marcado de hipertexto (HTML, HyperText Markup Language), su elemento img y sus atributos height y width, los cuales especifican la altura y el ancho de una imagen (las unidades por defecto son pixeles).

Por ejemplo, la expresión HTML:

<img src="img/maquina-turing.png" height="300" alt="Imagen local">

genera como salida una imagen de 300 pixeles de altura:

Si se usa solo el atributo height, width se ajusta automáticamente y viceversa.

Listas numeradas#

Se definen con números (1. 2. 3. ...) antes de cada elemento.

Sintaxis Markdown	Salida
1. Primer elemento. 2. Segundo elemento. 3. Tercer elemento.	1. Primer elemento. 2. Segundo elemento. 3. Tercer elemento.

Listas no numeradas#

Se definen con guiones (-) o asteriscos (*) antes de cada elemento.

Sintaxis Markdown	Salida
- Un elemento. - Otro elemento. - Otro elemento más.	- Un elemento. - Otro elemento. - Otro elemento más.

Notación matemática#

Las expresiones en notación matemática (ej. ecuaciones) se escriben con base en la sintaxis de LaTeX. Se delimitan (al inicio y al final) con:

Un símbolo de dólar ($), para ecuaciones dentro de un renglón (inline math).
Dos símbolos de dólar ($$), para ecuaciones en su propio bloque (display math).

Ejemplo de inline math#

Sintaxis Markdown

Equivalencia entre masa y energía: $E = mc^{2}$

Salida
Equivalencia entre masa y energía: $E = mc^{2}$

Ejemplo de display math#

Sintaxis Markdown

Equivalencia entre masa y energía:

$$E = mc^{2}$$

Salida
Equivalencia entre masa y energía:

\[E = mc^{2}\]

Para más detalles sobre la sintaxis de las expresiones matemáticas, se recomienda consultar:

Ejercicios#

Con VSCode, cree un documento Markdown llamado README.md y escriba en este un breve curriculum académico o profesional (puede elegir otro tema).

a. Incluya información como: nombre, fotografía, datos de contacto, áreas de interés, carrera, cursos aprobados, publicaciones, etc.
b. Puede usar información ficticia (no incluya datos confidenciales o sensibles).
c. Especifique la fuente de las imágenes (y de cualquier otra información para la que sea necesario) y no utilice imágenes para las que no tiene autorización. Considere utilizar sitios con imágenes con licencias abiertas (ej. Wikimedia Commons, Unsplash, FreeImages).
d. Asegúrese de utilizar los siguientes elementos de sintaxis Markdown:
```
 -   Encabezados de varios niveles.
 -   Negritas e itálicas.
 -   Listas.
 -   Enlaces a sitios web.
 -   Imágenes (al menos una local y una remota).
```
En GitHub, cree un repositorio llamado cv y suba el archivo creado en el paso 1.
Publique el documento en GitHub Pages con Settings > Pages > Branch > Save.

Recursos de interés#

Daring Fireball: Markdown. (s. f.). Recuperado 25 de marzo de 2023, de https://daringfireball.net/projects/markdown/

LaTeX/Mathematics—Wikibooks, open books for an open world. (s. f.). Recuperado 25 de marzo de 2023, de https://en.wikibooks.org/wiki/LaTeX/Mathematics

Markdown Guide. (s. f.). Recuperado 10 de abril de 2022, de https://www.markdownguide.org/

Writing mathematical expressions. (s. f.). GitHub Docs. Recuperado 25 de marzo de 2023, de https://ghdocs-prod.azurewebsites.net/en/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions