Modulo 1: Que es Markdown y por que aprenderlo?

Una breve historia

En 2004, John Gruber y Aaron Swartz crearon Markdown con una idea simple pero poderosa: permitir que cualquier persona escriba texto con formato usando solo caracteres de texto plano.

Antes de Markdown, si querias escribir un documento con formato tenias dos caminos:

1. Usar un procesador de texto como Word (pesado, formato propietario).
2. Escribir HTML a mano (verboso, dificil de leer en crudo).

Markdown nacio como un punto medio: un formato que se lee facilmente como texto plano y se convierte a HTML con un simple procesador.

Que problema resuelve Markdown?

Imagina que necesitas escribir documentacion para un proyecto. Tienes varias opciones:

• Un archivo Word: funciona, pero necesitas Microsoft Office o similar para abrirlo. El formato puede romperse entre versiones. No se integra bien con Git.
• HTML puro: es universal, pero escribir <strong>texto</strong> cada vez que quieres negrita es agotador y dificil de leer.
• Markdown: escribes **texto** y listo. Se lee perfectamente como texto plano y se convierte a HTML cuando lo necesitas.

Comparacion lado a lado

Veamos como se ve la misma tarea en cada formato:

Crear un titulo y un parrafo en negrita:

En Word:

(Seleccionar texto -> Menu -> Titulo 1 -> Seleccionar texto -> Boton Negrita)
No hay representacion en texto plano. Depende del editor.

En HTML:

<h1>Mi titulo</h1>
<p><strong>Este texto es importante.</strong></p>

En Markdown:

# Mi titulo

**Este texto es importante.**

Donde se usa Markdown?

Markdown esta en todas partes, probablemente ya lo usas sin darte cuenta. Para empezar, si alguna vez has abierto un repositorio en GitHub o GitLab, lo primero que ves es el archivo README.md, que esta escrito en Markdown. Los issues, pull requests y comentarios en estas plataformas tambien usan Markdown, asi que si colaboras en proyectos de codigo abierto, ya estas inmerso en este formato.

Ahora bien, el uso de Markdown va mucho mas alla del codigo. En el mundo de la documentacion tecnica y la publicacion cientifica, herramientas como MkDocs, Docusaurus, Astro y Hugo usan archivos Markdown como fuente de contenido para generar sitios de documentacion completos. Quarto merece mencion especial: es un sistema de publicacion cientifica y tecnica que usa Markdown como base para generar documentos, presentaciones, sitios web, libros y articulos academicos. Se integra con R, Python y Julia para crear documentos reproducibles. No lo cubriremos en este curso, pero si trabajas en ciencia de datos o investigacion, vale mucho la pena explorarlo (quarto.org).

Algo similar ocurre con los blogs y sitios estaticos. Plataformas como Jekyll, Gatsby, Next.js y Astro permiten escribir articulos de blog en Markdown que se convierten automaticamente en paginas web. Esto es porque Markdown separa el contenido de la presentacion, lo cual resulta ideal para flujos de publicacion modernos.

Tambien encontraras Markdown en las aplicaciones de notas que probablemente ya usas. Obsidian te permite construir tu segundo cerebro con archivos Markdown. Notion soporta atajos de Markdown para formato rapido. Y editores como Bear, Typora e iA Writer estan disenados completamente alrededor de Markdown.

Lo interesante es que incluso las plataformas de mensajeria y comunicacion han adoptado Markdown o algo muy parecido. Slack usa un subconjunto de Markdown para negrita, cursiva y codigo. Discord soporta Markdown completo en los mensajes. Reddit formatea sus comentarios con Markdown. Telegram soporta formato Markdown en mensajes. Y WhatsApp, aunque no es Markdown “oficial”, usa convenciones muy parecidas: *negrita*, _cursiva_, ~tachado~ y `codigo`. Si ya formateaste un mensaje en WhatsApp, ya usaste algo muy cercano a Markdown.

Por ultimo, incluso en el correo electronico puedes usar Markdown: aplicaciones como Mailchimp y clientes como Thunderbird permiten componer correos en este formato.

Ventajas de usar Markdown

Una de las grandes virtudes de Markdown es su portabilidad: un archivo .md es texto plano, lo que significa que se abre con cualquier editor de texto en cualquier sistema operativo sin necesitar software especial. Esto conecta directamente con otra ventaja fundamental, la legibilidad. A diferencia de HTML, un archivo Markdown se lee perfectamente sin renderizar, porque el formato es intuitivo y no estorba la lectura.

Ademas, Markdown te da velocidad. No necesitas quitar las manos del teclado para buscar botones en una barra de herramientas; todo el formato se aplica escribiendo. Y como es un formato tan extendido, goza de una universalidad enorme: funciona en GitHub, editores de texto, aplicaciones de notas, generadores de sitios estaticos, sistemas de documentacion y muchas herramientas mas.

Hay dos ventajas adicionales que vale la pena destacar. La primera es el control de versiones: al ser texto plano, los archivos Markdown funcionan perfectamente con Git, lo que te permite ver exactamente que cambio entre dos versiones de un documento. La segunda es la convertibilidad: con herramientas como Pandoc, puedes convertir Markdown a PDF, Word, HTML, LaTeX, EPUB y muchos otros formatos. En otras palabras, escribes una vez y publicas donde quieras.

Que NO es Markdown?

Es importante aclarar algunos malentendidos comunes para que no te lleves sorpresas.

Antes que nada, Markdown no es un lenguaje de programacion: no ejecuta codigo ni tiene logica. Tampoco es un procesador de texto al estilo de Word o Google Docs; si necesitas documentos con diseno complejo (columnas, margenes personalizados, etc.), Markdown no es la herramienta adecuada. En esa misma linea, Markdown no es un formato de diseno: no controlas colores, fuentes ni disposicion visual, solo defines la estructura y el formato basico del contenido. Por ultimo, conviene saber que Markdown no es un estandar unico: existen variantes como CommonMark, GitHub Flavored Markdown (GFM), MultiMarkdown y otras, cada una con extensiones propias.

Entonces, que SI es Markdown? Es un formato de texto plano con convenciones para indicar estructura. Es una herramienta para escribir contenido de forma rapida y limpia. Y es, esencialmente, un puente entre texto plano y documentos formateados: escribes de manera natural y obtienes un resultado con formato profesional.

El ecosistema Markdown

A lo largo del tiempo, Markdown ha inspirado variantes y extensiones:

Resumen del modulo

• Markdown fue creado en 2004 por John Gruber y Aaron Swartz.
• Resuelve el problema de escribir texto formateado sin depender de editores visuales ni de HTML verboso.
• Se usa en GitHub, documentacion tecnica, blogs, apps de notas y mensajeria.
• Es portatil, legible, rapido y universal.
• No es un lenguaje de programacion ni un procesador de texto.

Mini ejercicio

Piensa en tu dia a dia digital y responde las siguientes preguntas:

1. Identifica 3 lugares donde ya usas (o podrias usar) Markdown sin saberlo. Pueden ser aplicaciones, plataformas o herramientas.

2. Para cada lugar que identificaste, escribe un ejemplo concreto de como usarias Markdown ahi. Por ejemplo:

   • “En Discord, uso **texto** para resaltar mensajes importantes.”

3. Reflexion: si tuvieras que explicarle a un amigo que es Markdown en una sola frase, como lo dirias?

Modulo 3: Formato de texto basico

Encabezados

Los encabezados definen la estructura y jerarquia de tu documento. Markdown ofrece 6 niveles de encabezados, representados por el simbolo #.

# Encabezado nivel 1
## Encabezado nivel 2
### Encabezado nivel 3
#### Encabezado nivel 4
##### Encabezado nivel 5
###### Encabezado nivel 6

Reglas importantes para encabezados

Hay algunas reglas que debes tener en cuenta para que tus encabezados funcionen correctamente. La primera y mas basica es que siempre debes dejar un espacio entre el # y el texto. Sin ese espacio, Markdown no reconoce la linea como encabezado:

# Correcto
#Incorrecto

Tambien es importante que respetes la jerarquia y no saltes niveles. Si tienes un # seguido de un ##, el siguiente nivel deberia ser ###, no ####. Saltarte niveles confunde tanto a los lectores como a las herramientas de accesibilidad:

# Titulo
## Seccion
### Subseccion (correcto: sigue la jerarquia)

# Titulo
#### Subseccion (incorrecto: saltaste ## y ###)

Ademas, procura usar un solo # por documento para el titulo principal. Esto le da a tu documento un punto de entrada claro y una estructura coherente. Por ultimo, deja siempre una linea en blanco antes y despues de cada encabezado para que el texto respire y Markdown pueda interpretar todo sin ambiguedad:

Texto del parrafo anterior.

## Mi seccion

Texto del parrafo siguiente.

Titulo nivel 1
===============

Titulo nivel 2
---------------

Parrafos y saltos de linea

Parrafos

En Markdown, los parrafos se separan con una linea en blanco:

Este es el primer parrafo. Puede tener
varias lineas seguidas y Markdown las
une en un solo parrafo.

Este es el segundo parrafo. La linea en
blanco entre ambos es lo que los separa.

Si no dejas la linea en blanco, Markdown une todo en un solo parrafo:

Esta linea
y esta otra linea
se renderizan como un solo parrafo continuo.

Saltos de linea (line breaks)

A veces quieres un salto de linea dentro del mismo parrafo sin crear un parrafo nuevo. Hay dos formas:

Metodo 1: Dos espacios al final de la linea

Primera linea
Segunda linea (hay 2 espacios invisibles al final de la linea anterior)

Metodo 2: Etiqueta HTML <br>

Primera linea<br>
Segunda linea

La siguiente tabla resume las formas de controlar parrafos y saltos de linea:

Negrita

Para poner texto en negrita, envuelvelo con dos asteriscos o dos guiones bajos:

**Este texto esta en negrita**
__Este tambien esta en negrita__

Ambas formas producen el mismo resultado. La convencion mas comun es usar asteriscos dobles (**).

Negrita dentro de una palabra

Hay un detalle que vale la pena conocer: los asteriscos funcionan a mitad de una palabra, pero los guiones bajos no. Esto es porque Markdown trata los guiones bajos de forma especial cuando estan pegados a letras, para evitar conflictos con nombres de variables o archivos que usan guiones bajos. Los asteriscos, en cambio, siempre se interpretan como formato:

Un texto in**crei**ble    (funciona: increiblmente en negrita parcial)
Un texto in__crei__ble    (no funciona correctamente)

Cursiva

Para cursiva, usa un asterisco o un guion bajo:

*Este texto esta en cursiva*
_Este tambien esta en cursiva_

Al igual que con la negrita, los asteriscos son mas fiables dentro de palabras. La razon es la misma: los guiones bajos pueden confundir al procesador cuando aparecen en medio de una palabra, mientras que los asteriscos siempre se interpretan correctamente:

Un texto in*crei*ble    (funciona)
Un texto in_crei_ble    (puede no funcionar)

Tachado

Para tachar texto, envuelvelo con dos virgulillas (~~):

~~Este texto esta tachado~~

El tachado es especialmente util para indicar correcciones o cambios dentro de un documento, de modo que el lector pueda ver que se modifico:

El precio es ~~$50~~ $35 con descuento.

Combinaciones de formato

Puedes combinar negrita, cursiva y tachado para lograr exactamente el enfasis que necesitas.

Negrita + cursiva

La forma mas directa de combinar negrita y cursiva es usar tres asteriscos:

***Este texto esta en negrita y cursiva***

Tambien puedes anidar formatos cuando solo quieres que una parte del texto tenga el formato combinado:

**Texto en negrita con _una palabra en cursiva_ dentro**
*Texto en cursiva con **una palabra en negrita** dentro*

Todas las combinaciones

La siguiente tabla muestra todas las combinaciones posibles. No necesitas memorizarlas ahora; vuelve a consultarla cuando la necesites:

Ejemplo practico

Veamos un ejemplo que combina varios formatos en un contexto realista:

La fecha limite es el ~~15 de marzo~~ **20 de marzo**.
Recuerda que es ***muy importante*** entregar a tiempo.
El formato del documento debe ser *profesional* y **claro**.

Lineas horizontales

Las lineas horizontales crean una separacion visual entre secciones. Se crean con tres o mas de estos caracteres:

---
***
___

Las tres formas producen el mismo resultado: una linea horizontal (<hr>).

Reglas para lineas horizontales

Las lineas horizontales deben estar en su propia linea, sin otro contenido a los lados. Ademas, es muy importante que dejes una linea en blanco antes y despues de la linea horizontal, especialmente antes. Esto es porque si escribes --- justo debajo de un texto sin linea en blanco, Markdown puede interpretarlo como un encabezado nivel 2 en formato Setext en lugar de una linea divisoria:

Fin de la seccion anterior.

---

Inicio de la nueva seccion.

Esto se convierte en encabezado
---

Texto literal y caracteres especiales

A veces necesitas mostrar caracteres que Markdown interpretaria como formato. Para esto, usa la barra invertida (\) como caracter de escape:

\*Este texto no esta en cursiva\*
\# Esto no es un encabezado
\- Esto no es una lista

Caracteres que puedes escapar

\   barra invertida
*   asterisco
_   guion bajo
#   almohadilla
+   signo mas
-   guion
.   punto
!   exclamacion
|   barra vertical
~   virgulilla
`   acento grave

Resumen del modulo

Mini ejercicio

Crea un archivo llamado presentacion.md con tu presentacion personal usando todo el formato que aprendiste en este modulo. Debe incluir:

1. Un titulo con tu nombre (encabezado nivel 1).
2. Una seccion “Sobre mi” (encabezado nivel 2) con un parrafo que use negrita para tu profesion y cursiva para un dato curioso.
3. Una seccion “Experiencia” (encabezado nivel 2) con al menos una correccion usando tachado.
4. Una frase destacada usando negrita y cursiva combinadas.
5. Lineas horizontales separando las secciones principales.
6. Al menos un caracter escapado (por ejemplo, mostrando un asterisco literal).

Ejemplo de estructura esperada

# Maria Lopez

---

## Sobre mi

Soy **disenadora grafica** con 5 anios de experiencia.
Un dato curioso: *tengo 3 gatos que se llaman como lenguajes
de programacion*.

---

## Experiencia

Trabajo actualmente en ~~una startup~~ una empresa de tecnologia
con presencia en 10 paises.

***Me apasiona crear interfaces que la gente disfrute usar.***

---

Para escribir un asterisco literal en Markdown, uso: \*

Modulo 5: Enlaces e imagenes

Los enlaces y las imagenes son lo que convierten un documento de texto plano en un documento conectado con el mundo. Mientras que el formato de texto le da estructura visual a tus ideas, los enlaces les dan profundidad al conectarlas con otros recursos, y las imagenes les dan riqueza al aportar contexto visual. En este modulo aprenderemos todas las formas que Markdown ofrece para crear hipervinculos e insertar imagenes, empezando por la mas sencilla y avanzando hacia las mas sofisticadas.

Enlaces inline

La forma mas comun de crear un enlace en Markdown es el formato inline. Se escribe el texto visible entre corchetes y la URL entre parentesis, todo junto, sin espacios. Piensa en los corchetes como una etiqueta que describe el destino y en los parentesis como la direccion a la que apunta esa etiqueta.

[Visita Google](https://www.google.com)

Esto genera un enlace donde el texto “Visita Google” es clickeable y lleva a la URL indicada. El lector vera unicamente el texto entre corchetes, estilizado como un hipervinculo, mientras que la URL permanece oculta detras.

Enlaces con titulo

Una vez que dominas los enlaces basicos, puedes enriquecerlos con un texto de titulo que aparecera como tooltip al pasar el cursor sobre el enlace. Para agregarlo, simplemente escribe el titulo entre comillas dobles despues de la URL, pero dentro de los parentesis.

[Visita Google](https://www.google.com "El buscador mas popular")

El titulo es opcional pero mejora la accesibilidad y da contexto adicional al usuario. Resulta especialmente util cuando el texto del enlace es breve y la URL no deja claro que encontrara el lector al hacer click.

Enlaces de referencia

Cuando un documento tiene muchos enlaces, los enlaces inline pueden dificultar la lectura del texto fuente. Imagina un parrafo con tres o cuatro URLs largas intercaladas: el codigo Markdown se vuelve dificil de leer y de editar. Los enlaces de referencia resuelven este problema separando la URL del texto, de forma muy parecida a como funcionan las notas al pie en un libro.

Se usan en dos partes:

1. En el texto, usas una etiqueta de referencia entre corchetes:

Puedes buscar en [Google][1] o en [Bing][2] segun tu preferencia.

2. Al final del documento (o en cualquier parte), defines las referencias:

[1]: https://www.google.com "Google"
[2]: https://www.bing.com "Bing"

Tambien puedes usar el propio texto como referencia si coincide con la etiqueta. Esto simplifica aun mas la sintaxis cuando el texto del enlace y la etiqueta son identicos:

Busca en [Google][] para encontrar lo que necesites.

[Google]: https://www.google.com

URLs automaticas

A veces no necesitas un texto descriptivo y simplemente quieres mostrar una URL tal cual como enlace clickeable. Para estos casos, Markdown ofrece las URLs automaticas: basta con encerrar la direccion entre los signos de menor y mayor.

<https://www.ejemplo.com>
<usuario@correo.com>

Este formato tambien funciona con direcciones de correo electronico, generando automaticamente un enlace mailto:.

Imagenes

Ahora que conoces todas las variantes de enlaces, aprender la sintaxis de imagenes sera muy sencillo, porque Markdown las trata como una extension directa de los enlaces. La unica diferencia es que las imagenes llevan un signo de exclamacion ! al inicio. El texto entre corchetes se convierte en el texto alternativo (atributo alt), que es fundamental para la accesibilidad, ya que permite a lectores de pantalla describir la imagen a usuarios con discapacidad visual.

![Logo de Markdown](https://markdown-here.com/img/icon256.png)

Sintaxis	Resultado	Descripción
		Imagen basica
		Imagen con titulo

Imagenes con titulo

Igual que con los enlaces, puedes agregar un titulo a las imagenes colocando el texto entre comillas dobles despues de la URL. Este titulo aparecera como tooltip al pasar el cursor sobre la imagen, proporcionando informacion adicional sin ocupar espacio visible en el documento.

![Paisaje de montana](./images/montana.jpg "Foto tomada en los Andes")

El titulo aparecera como tooltip al pasar el cursor sobre la imagen.

Rutas relativas vs absolutas

Cuando enlazas archivos o imagenes, es importante entender la diferencia entre los dos tipos de rutas disponibles, ya que elegir la correcta afecta tanto la portabilidad de tu proyecto como la fiabilidad de tus enlaces.

Las rutas absolutas incluyen la URL completa desde el protocolo. Son las que usas cuando el recurso vive en internet, fuera de tu proyecto. No importa desde donde se abra tu documento: la ruta siempre apuntara al mismo lugar.

![Logo](https://www.ejemplo.com/images/logo.png)
[Documento](https://www.ejemplo.com/docs/guia.pdf)

Las rutas relativas, en cambio, describen la ubicacion del recurso en relacion con la posicion del archivo actual. Son ideales para recursos que viven dentro de tu propio proyecto, como imagenes locales u otros documentos. Si mueves todo el proyecto a otra carpeta o a otro servidor, las rutas relativas seguiran funcionando porque la relacion entre archivos no cambia.

![Logo](./images/logo.png)
[Documento](../docs/guia.pdf)

Diferencia entre enlaces e imagenes

Como ya habras notado a lo largo del modulo, la sintaxis de enlaces e imagenes es casi identica. La unica diferencia es el signo de exclamacion ! al inicio: si lo incluyes, Markdown entiende que debe mostrar el recurso como imagen incrustada; si lo omites, crea un hipervinculo de texto convencional.

[Esto es un enlace](https://ejemplo.com)
![Esto es una imagen](https://ejemplo.com/foto.png)

Sintaxis	Resultado	Descripción
[texto](url)	texto	Enlace: sin ! al inicio
		Imagen: con ! al inicio

Conocer esta relacion entre ambas sintaxis abre una posibilidad interesante: puedes combinar las dos para crear una imagen que funcione como enlace. La idea es colocar la sintaxis de imagen completa en el lugar donde normalmente iria el texto del enlace.

[![Texto alternativo](imagen.png)](https://ejemplo.com)

En este caso, el lector ve la imagen en el documento y, al hacer click en ella, navega a la URL del enlace. Es un patron muy comun para logos que llevan a una pagina principal o para miniaturas que enlazan a una version en alta resolucion.

Resumen de sintaxis

Sintaxis	Resultado	Descripción
[texto](url)	texto	Enlace inline
[texto](url "titulo")	texto	Enlace con titulo
[texto][ref]	—	Enlace de referencia
<url>	—	URL automatica
		Imagen
		Imagen con titulo
[](url)	—	Imagen como enlace

Mini ejercicio

Ahora que conoces todas las formas de crear enlaces e imagenes en Markdown, es momento de ponerlas en practica en un solo documento. El objetivo de este ejercicio es que combines las distintas sintaxis que has aprendido para crear un documento conectado y visual.

Empieza por crear tres enlaces a tus sitios web favoritos, asegurandote de que cada uno tenga un texto descriptivo y un titulo que aparezca como tooltip. Por ejemplo:

[Wikipedia](https://es.wikipedia.org "La enciclopedia libre")

A continuacion, agrega un enlace de referencia a algun recurso que quieras compartir. Recuerda que la definicion de la referencia debe ir al final del documento, separada del texto principal. Esto te dara practica con la sintaxis de dos partes que mantiene limpio el texto fuente.

Despues, inserta una imagen con texto alternativo descriptivo. Puedes usar cualquier URL de imagen publica; lo importante es que el texto alternativo describa con precision lo que muestra la imagen. Por ejemplo:

![Gatito programador](https://placekitten.com/400/300 "Un gato muy concentrado")

Finalmente, crea una imagen que funcione como enlace: al hacer click en la imagen, el lector debe navegar a una URL de tu eleccion. Este ultimo punto combina las dos sintaxis principales del modulo y es una excelente forma de verificar que entiendes como se relacionan entre si.

Modulo 7: Tablas y citas

Las tablas y las citas (blockquotes) son dos herramientas que elevan tus documentos Markdown de simples textos formateados a documentos verdaderamente profesionales. Las tablas te permiten organizar datos en filas y columnas de forma clara y comparativa, mientras que las citas te dan la capacidad de destacar informacion, referenciar fuentes externas o resaltar notas importantes. En este modulo aprenderemos a dominar ambas, empezando por la construccion de tablas desde cero y avanzando hasta su combinacion con citas en documentos tecnicos completos.

Tablas basicas con pipes

Las tablas en Markdown se construyen usando el caracter pipe (|) para separar columnas y guiones (-) para crear la linea que separa el encabezado del contenido. Aunque la sintaxis puede parecer un poco artesanal comparada con un editor visual de hojas de calculo, tiene la ventaja de ser puro texto y, por lo tanto, perfectamente compatible con el control de versiones.

| Lenguaje   | Creador          | Ano  |
|------------|------------------|------|
| Python     | Guido van Rossum | 1991 |
| JavaScript | Brendan Eich     | 1995 |
| Go         | Google           | 2009 |

Reglas basicas

Para que una tabla funcione correctamente, hay algunas convenciones que debes tener en cuenta. Cada fila debe tener el mismo numero de columnas; si una fila tiene menos pipes que las demas, el resultado sera impredecible segun el procesador que uses. Los pipes al inicio y al final de cada fila son opcionales pero recomendados, ya que mejoran significativamente la legibilidad del codigo fuente. Por ultimo, no es necesario que las columnas esten perfectamente alineadas en el texto fuente, aunque se ve mucho mejor si lo estan y facilita la edicion posterior.

Este ejemplo es valido aunque no este alineado:

|Nombre|Edad|Ciudad|
|-|-|-|
|Ana|28|Madrid|
|Luis|34|Mexico|

Alineacion de columnas

Por defecto, el texto de las celdas se alinea a la izquierda. Sin embargo, puedes controlar la alineacion de cada columna individualmente usando dos puntos (:) en la fila de separacion. Esta capacidad resulta especialmente valiosa cuando trabajas con datos numericos, donde la alineacion a la derecha mejora enormemente la legibilidad.

| Producto     | Cantidad | Precio   |
|:-------------|:--------:|---------:|
| Manzanas     | 5        | $2.50    |
| Pan integral | 2        | $3.75    |
| Leche        | 1        | $1.20    |
| **Total**    |          | **$7.45**|

La alineacion a la derecha es especialmente util para columnas con numeros o precios, donde los valores se leen mejor alineados por la derecha. La alineacion centrada, por su parte, funciona bien para categorias cortas o estados. Veamos un ejemplo mas elaborado que combina las tres alineaciones en un contexto financiero:

| Concepto       | Monto     |
|:---------------|----------:|
| Salario        | $3,500.00 |
| Alquiler       | -$800.00  |
| Alimentacion   | -$400.00  |
| Transporte     | -$150.00  |
| **Disponible** | **$2,150.00** |

Formato dentro de tablas

Una de las ventajas de las tablas en Markdown es que las celdas no estan limitadas a texto plano. Puedes usar practicamente cualquier formato Markdown dentro de ellas: negrita, cursiva, codigo inline, enlaces e incluso texto tachado. Esto te permite crear tablas ricas e informativas sin necesidad de recurrir a HTML.

| Formato       | Sintaxis          | Ejemplo            |
|:--------------|:------------------|:-------------------|
| Negrita       | `**texto**`       | **importante**     |
| Cursiva       | `*texto*`         | *enfasis*          |
| Codigo        | `` `codigo` ``    | `variable`         |
| Enlace        | `[texto](url)`    | [Google](https://google.com) |
| Tachado       | `~~texto~~`       | ~~eliminado~~      |

Blockquotes con >

Dejando las tablas a un lado, pasemos a la segunda herramienta protagonista de este modulo: las citas o blockquotes. Las citas se crean anteponiendo el signo mayor que (>) al inicio de cada linea. A primera vista pueden parecer un recurso simple, pero son extraordinariamente versatiles: se usan para citar texto de otra fuente, destacar informacion importante, mostrar notas, advertencias, e incluso representar conversaciones.

> La imaginacion es mas importante que el conocimiento.
> El conocimiento es limitado, la imaginacion rodea al mundo.
>
> — Albert Einstein

Citas de un parrafo

La forma mas sencilla de cita es la de un solo parrafo. Basta con poner > al inicio de la linea y escribir el contenido a continuacion. Este formato es perfecto para frases celebres, definiciones rapidas o notas breves.

> En medio de la dificultad reside la oportunidad. — Albert Einstein

Citas de multiples parrafos

Cuando la cita es mas extensa y abarca varios parrafos, necesitas mantener el signo > incluso en las lineas en blanco que separan los parrafos. De lo contrario, Markdown interpretara que la cita termino en la linea vacia y el segundo parrafo aparecera como texto normal fuera de la cita.

> El primer parrafo de la cita explica el contexto
> y establece la idea principal.
>
> El segundo parrafo desarrolla la idea con mas
> detalle y aporta evidencia.

Citas anidadas

Las citas pueden contener otras citas dentro de si, creando niveles de profundidad que son ideales para representar conversaciones, hilos de respuesta o comentarios sobre una cita original. Para anidar, simplemente agrega signos > adicionales: dos para el segundo nivel, tres para el tercero, y asi sucesivamente.

> Esta es una cita original de alguien.
>
>> Y esta es una respuesta a esa cita.
>>
>>> Y esta es una respuesta a la respuesta.

Un uso practico muy comun de las citas anidadas es representar hilos de soporte tecnico o conversaciones en foros, donde cada nivel de anidacion indica una respuesta al mensaje anterior:

> **Usuario:** No puedo instalar el paquete con npm.
>
>> **Soporte:** Que version de Node estas usando? Intenta con `npm cache clean --force`.
>>
>>> **Usuario:** Uso Node 18. Limpiar la cache funciono, gracias!

Citas con formato

Dentro de una cita puedes usar cualquier formato de Markdown: negrita, cursiva, codigo, enlaces, listas e incluso encabezados. Esta flexibilidad convierte a los blockquotes en contenedores versatiles que pueden albergar contenido tan rico como cualquier otra seccion del documento.

> ### Nota importante
>
> Este proceso requiere los siguientes pasos:
>
> 1. Instalar las **dependencias** con `npm install`
> 2. Configurar el archivo `.env`
> 3. Ejecutar `npm run dev`
>
> Para mas informacion, consulta la [documentacion oficial](https://ejemplo.com).

Incluso puedes incluir bloques de codigo completos dentro de una cita, lo cual resulta muy util cuando quieres mostrar un ejemplo acompanado de su contexto o explicacion sin que el lector pierda de vista que todo forma parte de una nota destacada:

> Para imprimir en Python, usa la funcion `print()`:
>
> ```python
> print("Hola desde una cita!")
> ```
>
> Esto funciona en **Python 3.x**.

Combinar tablas y citas en un documento

Hasta ahora hemos tratado tablas y citas como herramientas independientes, pero su verdadero poder se revela cuando las combinas en un mismo documento. En la practica, es muy comun que una tabla de datos necesite una nota aclaratoria o que una comparacion requiera citar su fuente. Las citas son el complemento perfecto para las tablas porque aportan contexto sin romper la estructura visual del documento.

Veamos un ejemplo donde una cita introductoria establece el marco temporal de los datos, seguida de la tabla con la informacion y una cita final que indica la fuente:

## Comparativa de frameworks

> **Nota:** Esta comparativa esta basada en datos de 2025.
> Los resultados pueden variar segun el caso de uso.

| Framework | Lenguaje   | Estrellas GitHub | Uso principal       |
|:----------|:-----------|:----------------:|:--------------------|
| React     | JavaScript | 220k+            | Interfaces de usuario |
| Django    | Python     | 78k+             | Backend web          |
| Rails     | Ruby       | 55k+             | Aplicaciones web     |
| Spring    | Java       | 73k+             | Aplicaciones empresariales |

> **Fuente:** Datos recopilados de GitHub y encuestas de
> Stack Overflow Developer Survey.

Otro patron comun es usar una cita como pie de tabla o para agregar un consejo relacionado con los datos que acabas de presentar:

| Comando           | Descripcion                    |
|:------------------|:-------------------------------|
| `git init`        | Inicializa un repositorio      |
| `git add .`       | Agrega todos los cambios       |
| `git commit -m`   | Crea un commit con mensaje     |
| `git push`        | Sube cambios al remoto         |

> **Tip:** Siempre ejecuta `git status` antes de `git commit`
> para verificar que solo estas incluyendo los archivos deseados.

Resumen de sintaxis

Tablas

Citas

Mini ejercicio

Este ejercicio te pide crear un documento que combine todo lo aprendido en el modulo. Trabajaras con tablas, citas y formato enriquecido en un solo documento cohesivo.

Parte 1: Tabla comparativa

Crea una tabla que compare al menos 4 lenguajes de programacion con las siguientes columnas:

• Nombre del lenguaje (alineado a la izquierda)
• Tipo (compilado/interpretado, alineado al centro)
• Ano de creacion (alineado a la derecha)
• Uso principal (alineado a la izquierda)

Aqui tienes un ejemplo de como empezar la tabla para que veas la estructura esperada:

| Lenguaje   | Tipo          | Ano  | Uso principal              |
|:-----------|:-------------:|-----:|:---------------------------|
| Python     | Interpretado  | 1991 | IA, ciencia de datos, web  |
| C          | Compilado     | 1972 | Sistemas operativos        |
| ...        | ...           | ...  | ...                        |

Parte 2: Cita famosa formateada

Elige una cita famosa sobre tecnologia o programacion y presentala con formato enriquecido. El objetivo es practicar la combinacion de blockquotes con formato Markdown para crear una cita visualmente atractiva.

1. Usa un blockquote (>) para la cita
2. Pon el texto principal en cursiva
3. Pon el nombre del autor en negrita
4. Agrega una cita anidada (>>) con un breve comentario tuyo sobre la cita

Ejemplo de estructura:

> *Cualquier tonto puede escribir codigo que una computadora
> puede entender. Los buenos programadores escriben codigo
> que los humanos pueden entender.*
>
> — **Martin Fowler**
>
>> Este principio me recuerda la importancia de escribir
>> codigo limpio y documentado.

Parte 3: Combinacion

Finalmente, agrega una cita antes o despues de tu tabla que sirva como nota o fuente de informacion. Esto te dara practica con el patron de tabla + contexto que vimos en la seccion de combinar tablas y citas.

Modulo 9: Enlaces internos y backlinks

Si Obsidian fuera solo un editor de Markdown, no tendria nada de especial. Lo que lo convierte en una herramienta poderosa para gestionar conocimiento son los enlaces internos: la capacidad de conectar notas entre si y navegar esa red de conexiones. En este modulo vamos a dominar esta funcionalidad.

1. Wikilinks: la killer feature de Obsidian

En Markdown estandar, los enlaces se escriben asi:

[texto visible](https://url.com)

Obsidian extiende esta sintaxis con wikilinks, una forma rapida de enlazar a otras notas dentro de tu vault:

[[nombre-de-nota]]

Eso es todo. Dos corchetes alrededor del nombre de una nota crean un enlace interno. Cuando haces clic en el, Obsidian te lleva a esa nota. Si la nota no existe, Obsidian la crea automaticamente al hacer clic.

Ejemplo practico

Imagina que tienes una nota llamada productividad.md y quieres enlazar a ella desde otra nota:

# Mis habitos

Para mejorar mi dia a dia, estoy aplicando tecnicas de [[productividad]]
que descubri leyendo [[Atomic Habits - James Clear]].

Tambien estoy usando [[Obsidian]] como mi herramienta principal de notas.

Cada [[...]] es un enlace clickeable a otra nota. Si las notas productividad, Atomic Habits - James Clear o Obsidian no existen todavia, aparecen con un color diferente para indicar que son notas por crear.

2. Sintaxis completa de wikilinks

Los wikilinks tienen varias formas segun lo que necesites:

Enlace basico

Estoy leyendo sobre [[Zettelkasten]].

Muestra “Zettelkasten” como enlace y apunta a la nota Zettelkasten.md.

Enlace con alias (texto visible)

A veces el nombre de la nota no queda bien en el flujo del texto. Usa el pipe | para cambiar lo que se muestra:

El [[Zettelkasten|metodo de fichas]] fue creado por Niklas Luhmann.

Muestra “metodo de fichas” como texto del enlace, pero apunta a la nota Zettelkasten.md.

Enlace a una seccion

Si quieres enlazar a un encabezado especifico dentro de otra nota, agrega # seguido del nombre del encabezado:

Revisa las [[productividad#Tecnica Pomodoro]] para sesiones de enfoque.

Esto te lleva directamente a la seccion “Tecnica Pomodoro” dentro de productividad.md. Al escribir # despues del nombre de la nota, Obsidian autocompleta los encabezados disponibles.

3. Backlinks: la magia de las conexiones bidireccionales

Hasta aqui hemos hablado de enlazar de una nota a otra, que es algo que cualquier editor puede hacer. Pero lo que realmente diferencia a Obsidian es lo que pasa del otro lado del enlace. Cada vez que creas un enlace de la nota A a la nota B, la nota B sabe que la nota A la enlaza. Estos enlaces inversos se llaman backlinks, y son la funcionalidad que transforma un conjunto de archivos sueltos en una red de conocimiento viva.

Como funcionan

Supongamos que tienes estas tres notas:

habitos.md:

# Habitos

Mis tecnicas favoritas de [[productividad]] incluyen
el bloqueo de tiempo y la [[Tecnica Pomodoro]].

lectura.md:

# Lectura

En [[Atomic Habits - James Clear]] aprendi sobre la importancia
de los sistemas vs las metas. Aplicar esto mejora mi [[productividad]].

Ahora, si abres la nota productividad.md y miras el panel de backlinks (panel derecho), veras que tanto habitos.md como lectura.md enlazan a esta nota, e incluso te muestra el contexto exacto donde aparece cada enlace. Sin que hayas hecho nada en productividad.md, esta nota ya sabe quien la referencia. Esto transforma tus notas de documentos aislados en una red interconectada.

Linked vs Unlinked mentions

El panel de backlinks muestra dos secciones que vale la pena entender. Las linked mentions son las mas obvias: notas que enlazan explicitamente con [[productividad]]. Pero las unlinked mentions son todavia mas interesantes: Obsidian detecta notas que mencionan la palabra “productividad” en su texto sin haber creado un enlace con [[]], y te sugiere convertirlas en enlaces con un solo clic.

4. Graph view: el mapa visual de tu conocimiento

De todas las funcionalidades de Obsidian, el graph view (vista de grafo) es probablemente la mas impactante visualmente y una de las mas utiles para entender tu propio pensamiento. Se trata de un mapa interactivo donde cada nota es un nodo (un punto) y cada enlace es una linea que conecta dos nodos. El resultado es una representacion visual de toda tu red de conocimiento.

Pero el graph view no es solo bonito. Es una herramienta de reflexion genuinamente util. Cuando miras el mapa de tus notas, empiezas a ver patrones que no son obvios leyendo nota por nota: areas de conocimiento que has desarrollado mucho (clusters densos de nodos), temas que creias conectados pero que en realidad estan aislados, y notas huerfanas que no tienen ningun enlace y probablemente necesitan integrarse mejor. Muchos usuarios revisan su grafo periodicamente como una practica de “mantenimiento intelectual” — es como mirar tu cerebro desde afuera.

Ademas, el graph view tiene un uso muy practico en el dia a dia: descubrir caminos entre ideas. Si estas trabajando en un tema y no recuerdas que mas escribiste al respecto, el grafo local de esa nota te muestra instantaneamente todo lo que esta conectado, a uno o dos niveles de distancia. Es como tener un indice visual que se construye solo.

Abrir el graph view

Como leer el grafo

Cuando abres el grafo, lo primero que notas son los nodos de diferentes tamanos. Los nodos grandes representan notas con muchas conexiones, los “hubs” de tu conocimiento. Los nodos pequenos tienen pocas conexiones, y los nodos huerfanos aparecen aislados, sin ningun enlace a otras notas. Tambien vas a notar clusters, que son grupos de notas muy conectadas entre si e indican temas o areas de conocimiento que has desarrollado.

Filtrar el grafo

El graph view tiene varias opciones para personalizar lo que ves. Puedes filtrar por tags para mostrar solo notas con ciertas etiquetas, o filtrar por carpeta para enfocarte en un area especifica. En el grafo local, puedes controlar la profundidad (cuantos niveles de conexiones se muestran), y tambien puedes asignar colores a grupos de notas segun su tag, carpeta o los resultados de una busqueda.

Grafo local vs grafo global

Hay dos formas de ver el grafo. El grafo global muestra todas las notas y conexiones del vault de una vez, lo cual es util para tener una vista panoramica de todo tu conocimiento. El grafo local, en cambio, muestra solo las conexiones de una nota especifica; abrelo haciendo clic derecho en una nota y seleccionando “Open local graph”. Este ultimo es mas practico en el dia a dia porque te permite explorar el contexto inmediato de lo que estas trabajando sin perderte en la marana completa.

Colores y grupos en el grafo

Una funcionalidad que muchos pasan por alto es la posibilidad de colorear nodos por grupos. En la configuracion del graph view puedes crear reglas como “todas las notas con tag #proyecto se ven en verde” o “las notas en la carpeta recursos/ se ven en azul”. Esto transforma el grafo de una marana gris en un mapa tematico donde puedes identificar visualmente las areas de tu conocimiento de un vistazo.

5. Embeds: incrustar contenido de otras notas

Los enlaces te llevan a otra nota, pero a veces quieres traer el contenido de otra nota hacia ti, sin salir de donde estas. Para eso existen los embeds: puedes incrustar el contenido de una nota directamente dentro de otra. La sintaxis es similar a los wikilinks, pero con un ! al inicio.

Embed de nota completa

# Resumen semanal

## Lo que aprendi esta semana

![[aprendizajes-semana-12]]

## Metas para la proxima semana

![[metas-semana-13]]

Esto muestra el contenido completo de ambas notas directamente en el resumen semanal. Si las notas originales se actualizan, el embed refleja los cambios automaticamente.

Embed de una seccion

Si solo necesitas una parte de una nota:

# Mi rutina matutina

Empiezo el dia con la tecnica que aprendi aqui:

![[productividad#Tecnica Pomodoro]]

Solo se incrusta la seccion “Tecnica Pomodoro” de la nota productividad.md.

Embed de bloques

Para incrustar un parrafo o elemento especifico, usas block references. Primero, en la nota de origen, agrega un identificador al final del bloque:

La regla de los dos minutos dice que si algo toma menos
de dos minutos, hazlo ahora en lugar de posponerlo. ^regla-2min

Luego, en otra nota, incrusta ese bloque:

Una tecnica que me ayuda mucho con la procrastinacion:

![[productividad#^regla-2min]]

6. Imagenes en Obsidian

En el modulo 5 vimos como insertar imagenes con Markdown estandar (![alt](ruta)). En Obsidian, lo mas comun es usar la sintaxis de embeds que ya conocemos: simplemente arrastra una imagen a tu nota o pegala desde el portapapeles, y Obsidian la guarda automaticamente en tu vault y genera el embed por ti.

![[foto-vacaciones.png]]

Hasta ahi es sencillo. Pero hay algo que Markdown estandar no puede hacer y que en Obsidian es muy facil: redimensionar imagenes. Basta con agregar un pipe | seguido del ancho en pixeles, sin espacios. Esto es especialmente util cuando pegas capturas de pantalla con Ctrl+V y Obsidian genera algo como ![[Pasted image 20260323222827.png]] que ocupa toda la pantalla. Solo agrega el ancho deseado:

![[Pasted image 20260323222827.png|300]]

Eso muestra la imagen con un ancho de 300 pixeles, manteniendo la proporcion automaticamente. Si necesitas especificar tanto ancho como alto, separalos con x:

![[Pasted image 20260323222827.png|640x480]]

Para imagenes externas (con URL), la sintaxis es ligeramente diferente: el ancho va donde normalmente iria el texto alternativo:

![Descripcion|300](https://ejemplo.com/imagen.png)

Tambien funciona poner solo el numero como texto alt: ![300](url). Ambas formas son validas.

7. Block references

Las block references son una forma de apuntar a un parrafo, una lista o cualquier otro bloque especifico dentro de una nota, sin necesidad de que sea un encabezado. Mientras que los enlaces a secciones apuntan a encabezados (#), las block references te permiten enlazar cualquier fragmento de texto.

Como funcionan

Cualquier parrafo, item de lista o bloque de contenido puede recibir un identificador unico con la sintaxis ^id al final:

El principio de Pareto establece que el 80% de los resultados
provienen del 20% de los esfuerzos. ^pareto

Aplicaciones practicas:
- Identifica las pocas tareas que generan mayor impacto ^tareas-impacto
- Elimina o delega el resto

Ahora puedes enlazar o incrustar esos bloques desde cualquier otra nota:

Segun el [[productividad#^pareto|principio de Pareto]], deberia
enfocarme en las [[productividad#^tareas-impacto|tareas de mayor impacto]].

8. Resumen de sintaxis de Obsidian

Aqui tienes toda la sintaxis de enlaces y embeds en un solo lugar:

9. Buenas practicas para enlazar notas

Crear enlaces es facil. Crear enlaces utiles requiere algo de practica. Estas guias te ayudaran:

Enlaza con contexto

No hagas esto:

Ver [[productividad]].

Mejor asi:

Estoy aplicando la [[productividad#Tecnica Pomodoro|tecnica Pomodoro]]
para mantener sesiones de enfoque de 25 minutos.

El lector (y tu yo futuro) entiende por que existe el enlace sin tener que hacer clic.

Usa el principio del enlace “para mi futuro yo”

Cada vez que escribas algo, preguntate: “Si leo esto en 6 meses, entendere por que este enlace esta aqui?” Si la respuesta es no, agrega contexto.

No enlaces todo

No necesitas enlazar cada palabra que tenga su propia nota. Enlaza cuando la conexion aporta valor: cuando la nota enlazada expande o complementa la idea actual.

Mini ejercicio

Vamos a crear una mini red de conocimiento. Elige un tema que te interese (puede ser programacion, cocina, musica, fitness, historia, lo que quieras) y sigue estos pasos:

Paso 1: Crear 5 notas interconectadas

Crea 5 notas sobre tu tema. Por ejemplo, si eliges “Programacion web”:

1. programacion-web.md — nota general que enlaza a las demas
2. html.md — conceptos basicos de HTML
3. css.md — conceptos basicos de CSS
4. javascript.md — conceptos basicos de JavaScript
5. frameworks-frontend.md — frameworks como React, Vue, etc.

Cada nota debe:

• Tener al menos 2 enlaces [[]] a otras notas de las 5.
• Usar al menos un enlace con alias [[nota|texto visible]].
• Incluir al menos un enlace a una seccion especifica [[nota#seccion]].

Paso 2: Usar embeds

En la nota principal (la primera), agrega al menos un embed ![[nota#seccion]] que incruste una seccion interesante de otra nota.

Paso 3: Explorar los backlinks

1. Abre cada nota y revisa el panel de backlinks en el lateral derecho.
2. Identifica: cual nota tiene mas backlinks? Esa es tu nota “hub” del tema.

Paso 4: Explorar el graph view

1. Abre el graph view desde el Ribbon (icono de grafo en la barra lateral izquierda) o con Ctrl/Cmd + P y busca “graph”.
2. Observa como se conectan tus 5 notas.
3. Abre el local graph de tu nota principal y de alguna nota secundaria. Compara las vistas.

Paso 5: Reflexion

Responde en una nueva nota llamada reflexion-enlaces.md:

• Que nota termino siendo la mas conectada?
• Encontraste alguna conexion que no habias pensado inicialmente?
• Como te sientes navegando entre notas con enlaces vs buscando archivos en carpetas?

Rutinas de Practica Diaria

Aprender Markdown y Obsidian es como aprender a escribir: se necesita practica constante. Este plan de 3 semanas te llevara de principiante a usuario competente con sesiones cortas y enfocadas. No necesitas largas sesiones maratonicas; lo que realmente transforma tu habilidad es la repeticion diaria, aunque sea breve. Piensa en estas rutinas como un entrenamiento: cada dia construye sobre el anterior, y al final de las tres semanas miraras atras sorprendido de cuanto has avanzado.

Semana 1: Fundamentos de Markdown (15 min/dia)

El objetivo de esta semana es dominar la sintaxis basica de Markdown. Al final, podras crear documentos simples con formato profesional. Estos primeros dias son los mas importantes del curso: todo lo que viene despues se construye sobre estas bases, asi que no te apresures. Toma cada dia con calma, asegurate de que cada concepto quede solido, y avanza al siguiente solo cuando te sientas comodo.

Dia 1: Encabezados y parrafos

Los encabezados son la columna vertebral de cualquier documento. Son lo primero que un lector ve y lo que da estructura logica a tu contenido. Dominarlos desde el inicio te ahorrara reescrituras futuras, porque un documento con buena jerarquia de encabezados es un documento facil de navegar, de mantener y de ampliar.

Objetivo: Dominar los 6 niveles de encabezados y la separacion de parrafos.

Ejercicios:

1. Crea un documento con los 6 niveles de encabezado:

# Titulo principal
## Subtitulo
### Seccion
#### Subseccion
##### Detalle
###### Nota

2. Escribe 3 parrafos separados por lineas en blanco.

3. Practica saltos de linea dentro de un parrafo usando dos espacios al final o <br>.

Reto extra: Crea la estructura de un articulo con titulo, 3 secciones y 2 subsecciones en cada una.

Dia 2: Negrita, cursiva y tachado

Ahora que sabes estructurar un documento con encabezados, es hora de darle vida al texto que hay dentro de esas secciones. El enfasis textual es como el tono de voz en una conversacion: te permite resaltar lo importante, suavizar lo secundario y tachar lo que ya no aplica. Un buen uso del enfasis convierte un parrafo plano en algo que guia la atencion del lector exactamente donde quieres.

Objetivo: Aplicar enfasis al texto de forma fluida.

Ejercicios:

1. Escribe un parrafo usando cada tipo de enfasis:

Este texto tiene **negrita**, *cursiva* y ~~tachado~~.
Tambien puedes combinar ***negrita y cursiva***.

2. Reescribe el siguiente texto aplicando enfasis donde sea apropiado:

“Python es un lenguaje de programacion muy popular. La version 2 ya no tiene soporte. Se recomienda usar la version 3.12 o superior.”

3. Practica usando guiones bajos como alternativa: _cursiva_ y __negrita__.

Reto extra: Escribe 5 oraciones donde combines al menos dos tipos de enfasis en cada una.

Dia 3: Listas (todas las variantes)

Las listas son probablemente el elemento de Markdown que mas usaras en tu vida diaria. Desde listas de compras hasta documentacion tecnica, pasando por checklists de proyectos, no hay documento que no se beneficie de una buena lista. Este dia es especialmente importante porque las listas anidadas son una fuente frecuente de errores para principiantes, y dominar la indentacion ahora te evitara dolores de cabeza mas adelante.

Objetivo: Crear listas ordenadas, desordenadas, anidadas y de tareas.

Ejercicios:

1. Crea una lista de compras desordenada con sublistas:

- Frutas
  - Manzanas
  - Platanos
- Verduras
  - Zanahorias
  - Brocoli
- Lacteos
  - Leche
  - Queso

2. Crea una lista de pasos ordenada con sub-pasos:

1. Abrir el editor
2. Crear un archivo nuevo
3. Escribir el contenido
   1. Agregar titulo
   2. Agregar cuerpo
4. Guardar el archivo

3. Crea una lista de tareas con checkboxes:

- [x] Aprender encabezados
- [x] Aprender enfasis
- [ ] Dominar listas
- [ ] Practicar enlaces

Reto extra: Crea una lista de 3 niveles de profundidad que represente la estructura de carpetas de un proyecto.

Dia 4: Enlaces e imagenes

Los enlaces e imagenes son lo que convierte un documento de texto plano en un recurso verdaderamente util. Con enlaces, tu documento se conecta al mundo: puede referenciar fuentes, apuntar a otras secciones, o dirigir al lector hacia recursos complementarios. Las imagenes, por su parte, aportan contexto visual que a veces vale mas que mil palabras. La sintaxis de ambos es casi identica (solo difieren en un caracter), lo cual es elegante pero tambien una fuente comun de confusion, asi que presta atencion a los detalles.

Objetivo: Crear enlaces e insertar imagenes en todas sus formas.

Ejercicios:

1. Practica cada tipo de enlace:

[Enlace en linea](https://ejemplo.com)
[Enlace con titulo](https://ejemplo.com "Mi titulo")
[Enlace de referencia][ref1]
<https://enlace-automatico.com>

[ref1]: https://ejemplo.com "Referencia"

2. Practica la sintaxis de imagenes:

![Logo de Markdown](https://via.placeholder.com/200x100)
![Imagen local](./imagenes/foto.jpg "Descripcion")

3. Crea un indice de contenidos con enlaces internos:

## Indice
- [Seccion 1](#seccion-1)
- [Seccion 2](#seccion-2)

Reto extra: Crea una pagina de recursos con 10 enlaces organizados por categoria y al menos 3 imagenes.

Dia 5: Codigo inline y bloques

Si trabajas en tecnologia (o aspiras a hacerlo), este dia es fundamental. Saber insertar codigo en tus documentos es lo que distingue la documentacion profesional de las notas informales. El codigo inline te permite mencionar comandos, funciones o variables dentro de un parrafo sin romper el flujo de lectura. Los bloques de codigo, con su resaltado de sintaxis, hacen que los ejemplos sean claros y faciles de copiar. Despues de hoy, tus documentos tecnicos se veran significativamente mas pulidos.

Objetivo: Insertar codigo en linea y bloques con resaltado de sintaxis.

Ejercicios:

1. Usa codigo inline para mencionar comandos:

Usa `git status` para ver los cambios pendientes.
La funcion `print()` muestra texto en consola.

2. Crea bloques de codigo con resaltado de sintaxis:

```python
def saludar(nombre):
    return f"Hola, {nombre}!"
```

```r
saludar <- function(nombre) {
  paste("Hola,", nombre, "!")
}
```

3. Practica crear bloques de codigo con y sin lenguaje especifico.

Reto extra: Documenta 3 funciones de tu lenguaje favorito usando codigo inline y bloques.

Dias 6-7: Mini proyecto — Pagina “Sobre mi”

Esta es tu primera oportunidad de combinar todo lo aprendido en un documento real. Hasta ahora has practicado cada elemento por separado, como un musico que ensaya escalas. Ahora es momento de tocar una pieza completa. No te preocupes si necesitas consultar los dias anteriores; eso es parte normal del proceso. Lo importante es que intentes escribir todo el documento de principio a fin, tomando tus propias decisiones sobre estructura y formato.

Objetivo: Combinar todo lo aprendido en la semana en un documento real.

Requisitos del proyecto:

1. Titulo con tu nombre (H1)
2. Seccion “Sobre mi” con parrafos formateados (negrita, cursiva)
3. Seccion “Habilidades” con lista desordenada por categorias
4. Seccion “Experiencia” con lista ordenada
5. Seccion “Contacto” con enlaces
6. Al menos una imagen (puede ser un placeholder)
7. Una tabla con tu formacion academica
8. Uso de lineas horizontales para separar secciones

Semana 2: Markdown Intermedio (20 min/dia)

Bienvenido a la segunda semana. Si llegaste hasta aqui, ya tienes una base solida de Markdown. Ahora es momento de subir el nivel. Esta semana introduces elementos mas avanzados que son esenciales para crear documentacion tecnica profesional: tablas que organizan datos de forma clara, citas que resaltan informacion importante, y checklists que convierten tus documentos en herramientas de trabajo activas. Las sesiones son un poco mas largas (20 minutos), pero encontraras que el ritmo se siente natural porque ya tienes la mecanica basica interiorizada.

Dia 1: Tablas

Las tablas son uno de los elementos mas poderosos de Markdown para presentar datos estructurados. Cuando tienes informacion que se organiza naturalmente en filas y columnas (comparaciones, configuraciones, listas de opciones), una tabla comunica en segundos lo que un parrafo necesitaria varios minutos para explicar. La sintaxis puede parecer un poco rigida al principio, pero una vez que la dominas, crear tablas se vuelve casi automatico.

Ejercicios:

1. Crea una tabla simple:

| Nombre | Edad | Ciudad     |
|--------|------|------------|
| Ana    | 28   | Madrid     |
| Carlos | 35   | Barcelona  |
| Lucia  | 22   | Valencia   |

2. Practica la alineacion de columnas:

| Izquierda | Centro  | Derecha |
|:----------|:-------:|--------:|
| texto     | texto   |   texto |

3. Crea una tabla comparativa de al menos 3 columnas y 5 filas con formato dentro de las celdas (negrita, codigo, enlaces).

Dia 2: Citas y blockquotes

Las citas en Markdown son mucho mas versatiles de lo que parecen a primera vista. Si, puedes usarlas para citar a un autor, pero tambien son perfectas para resaltar advertencias, notas importantes o fragmentos de documentacion externa. Muchos desarrolladores las usan como “callouts” visuales para llamar la atencion sobre informacion critica. Aprende a dominarlas hoy y tendras una herramienta visual muy efectiva en tu arsenal.

Ejercicios:

1. Crea citas simples y anidadas:

> Esta es una cita simple.

> Esta es una cita
> que ocupa varias lineas.
>
> > Y esta es una cita anidada.