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.
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 otros contextos, 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: