Guía de Markdown

Markdown es un lenguaje de marcado que permite escribir usando una sintaxis sencilla con el objetivo de convertir el texto a formato HTML. Este lenguaje fue creado en el año 2004 por John Gruber con la ayuda de Aaron Swartz, y es popular en diversos entornos web debido a su facilidad de uso.

Encabezados

En Markdown, los encabezados emplean de 1 a 6 ‘#’ seguidos de un espacio en blanco y el texto del encabezado.

# Esto es un h1
## Esto es un h2
### Esto es un h3
#### Esto es un h4
##### Esto es un h5
###### Esto es un h6

Párrafos

Para indicar el final de un párrafo, basta con separar el texto con una línea en blanco.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis
facilisis sem. Nullam nec mi et neque pharetra sollicitudin.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis
facilisis sem. Nullam nec mi et neque pharetra sollicitudin.

Saltos de línea

Un salto de línea consta de un doble espacio antes de presionar la tecla ‘Enter’.

Lorem ipsum dolor sit amet,  
consectetuer adipiscing elit.  
Etiam lobortis facilisis sem.  
Nullam nec mi et neque pharetra sollicitudin.

Listas

Las listas ordenadas utilizan números seguidos de un punto, un espacio y el texto del elemento de la lista.

1. Lorem
2. Ipsum
3. Dolor

Similarmente, las listas desordenadas utilizan un guion, seguido de un espacio y el texto del elemento de la lista.

- Lorem
- ipsum
- dolor

Citas

Puedes indicar una cita con el símbolo ‘>’ seguido de un espacio y luego el texto de la cita.

> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam
> lobortis facilisis sem. Nullam nec mi et neque pharetra sollicitudin.
>
> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam
> lobortis facilisis sem. Nullam nec mi et neque pharetra sollicitudin.

Énfasis

El lenguaje Markdown usa los asteriscos ‘*’ como indicadores de énfasis.

*Texto en cursiva*
**Texto en negrilla**

Reglas horizontales

Es posible generar una regla horizontal con tres guiones en una línea.

---

Enlaces

Añade el texto del enlace entre corchetes, seguido por la dirección web entre paréntesis.

[Mi sitio web](https://alexisalzate.com)

También puedes añadir enlaces a modo de referencia.

[Mi sitio web][id]

[id]: https://alexisalzate.com

Nota: “id” puede ser reemplazado por cualquier cosa, los id suelen ser números.

Además, es posible usar el nombre implícito del enlace. Basta con utilizar un conjunto vacío de corchetes.

[Alexis Alzate][]

[Alexis Alzate]: https://alexisalzate.com

Imágenes

La sintaxis para añadir imágenes pretende parecerse a la sintaxis usada por los enlaces.

![Texto alternativo](/ruta/de/la/imagen.jpg)

o en forma de referencia:

![Texto alternativo][id]

[id]: ruta/de/la/imagen.jpg

Código

Para escribir líneas de código en Markdown, encierra el código entre comillas (`), o bloques de código entre tres comillas (```).

Así se escribe una línea de código:

`:(){ :|:& };:`

Así se escribe un bloque de código:

```#include <stdio.h>
int main() {
	printf("Hola, mundo!\n");
return 0;
}```

Sintaxis extendida

Existen características adicionales que no están incluidas en la especificación original de Markdown, pero que han sido implementadas en librerías para ofrecer funcionalidades más avanzadas de formato de texto.

Fórmulas matemáticas

Una funcionalidad de sintaxis extendida es la integración con fórmulas matemáticas utilizando la notación LaTeX.

Para asegurar el correcto funcionamiento, es necesario añadir las librerías de MathJax al head del documento HTML.

<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script type="text/javascript" id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>

Nota: Por defecto LaTeX utiliza los símbolos $…$ para insertar ecuaciones en línea, sin embargo, debido a la frecuencia con la que el símbolo ‘$’ es usado en otro tipo de textos, en la librería MathJax se reemplaza dicha notación por \\(…\\).

Ley de corrientes de Kirchhoff (LKC):
\begin{equation}
\sum_{n=1}^{N} I_n = 0
\end{equation}

Ley de voltajes de Kirchhoff (LVK):
$$\sum_{n=1}^{N} V_n = 0$$

Ley de Ohm:
\\(V = I * R\\)

Referencias: