¿Qué es Markdown?
Markdown es una clase especial de lenguaje que permite darle formato a texto simple. Por ejemplo, poder hacer cursivas, negritas, incorporar links, etc.
Para que el formato que se le ha dado pueda ser visto, el archivo en Markdown (.md) pasa por un convertidor universal llamado pandoc. Este, a diferencia de procesadores como los que ocupa Office no es pagado. Por ello, para no solo para editar tus archivos de texto no necesitarás un software, sino que para crear PDF, archivos .doc (Word), presentación (como las de Power Point) o HTML (para hacer sitios web) es completamente gratis. Solo debes encontrar un editor que pueda hacer esto.
La buena noticia es que ya lo conoces: ¡nuestro amigo RStudio!
Formatos básicos de Markdown
Escribe… | …o… | …para obtener |
---|---|---|
Algo de texto en el párrafo. |
Algo de texto. Algo de texto en el párrafo. Siempre utilizando espacios para dividir párrafos |
|
*Cursivas* |
_Cursivas_ |
Cursivas |
**Negrita** |
__Negrita__ |
Negrita |
# Título 1 |
Título 1 |
|
## Título 2 |
Título 2 |
|
### Título 3 |
Título 3 |
|
(puedes llegar hasta un título N° 6 con ###### ) |
||
[Link text](http://www.example.com) |
Link text | |
![Image caption](/path/to/image.png) |
||
`Inline code` with backticks |
Inline code with backticks |
|
> Citas |
|
|
- Cosas en - listas - desordenadas |
* Cosas en * listas * desordenadas |
|
1. Cosas en 2. listas 3. ordenadas |
1) Cosas en 2) listas 3) ordenadas |
|
Línea horizontal |
Línea horizontal |
Línea horizontal |
Expresiones matemáticas
Markdown también utiliza LaTeX para crear ecuaciones matemáticas (y no nos complica tanto la vida como el editor de Word). Si para tu tesis o un proyecto las utilizas te dejo esta guía de comando básicos para crear ecuaciones matemáticas.
Para introducir una ecuación debes poner los símbolos de peso ($)
La ecuación cuadratica es la siguiente
$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$
**Con ello obtendremos: **
La ecuación cuadratica es la siguiente
$$ x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
Evidentemente como el símbolo peso sirve para hacer ecuaciones matemáticas, no lo puedes utilizar en un archivo escrito en Markdown para hacer referencia realmente al símbolo peso. Para ello, debes escribir el símbolo antecedido con un (\
). Así obtendrás una frase escrita como " Te hago la tarea de R por \$100.000.
En caso contrario, si pones el símbólo pesos solo y sin \
entenderá la oración como una ecuación.
Tablas
Hacer tablas es muy fácil. Mira el siguiente ejemplo
Se escribe así
| Right | Left | Default | Center |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
Tabla: Descripción de la tabla
…to get…
Right | Left | Default | Center |
---|---|---|---|
12 | 12 | 12 | 12 |
123 | 123 | 123 | 123 |
1 | 1 | 1 | 1 |
Tabla: Descripción de la tabla
Pies de página
Para hacer pies de página debes saber cuál es su (1) identificador y (2) lo que quieres escribir en el pie de página. El identificador puede ser lo que tu quieras: pueden ser números como [^1]
, pero también pueden ser letras.
Debes escribir…
Aquí escribo una referencia de mi tesis[^1] y aquí otra más [^note-sobre-marx].
[^1]: Esta es una nota
[^note-sobre-marx]: Marx, lo más genial.
Y bueno, aquí sigo escribiendo
Para obtener
Aquí escribo una referencia de mi tesis1 y aquí otra más.2
Y bueno, aquí sigo escribiendo
La “cabeza” del Markdown
Al inicio del Markdown siempre debemos poner algunas informaciones sobre el documento, por ejemeplo, el título, la fecha, autor, etc. Esta parte del Markdown se llama YAML. Básicamente, con esto establecemos las “configuraciones” del texto.
Por ejemplo, si queremos que nuestro archivo esté en PDF, colores, si queremos que incluya bibliografía, entre otros. La “cabeza” del Markdown o YAMLS está dividida del resto del cuerpo del texto al inicio y al final con tres líneas (---
).
---
title: Título de mi tesis
date: "13 de Agosto, 2021"
author: "Estudiante UAH"
---
Debes poner este texto entre comillas. Si quieres ocupar comillas dentro de tu título, puedes utilizar comillas simples (e.g. mi tesis se titula Mi tesis: la más "genial" de Chile
), entonces ponemos
---
title: `Mi tesis: la más "genial" de Chile`
---
Otros recursos que te recomendamos revisar
En estos links podrás encontrar distintos ejemplos para practicar. También si quieres conocer más sobre quién creó esta maravilla, revisa sobre Aaron Swartz.
- CommonMark’s Markdown tutorial: A quick interactive Markdown tutorial.
- Markdown tutorial: Another interactive tutorial to practice using Markdown.
- Markdown cheatsheet: Useful one-page reminder of Markdown syntax.
- The Plain Person’s Guide to Plain Text Social Science: A comprehensive explanation and tutorial about why you should write data-based reports in Markdown.