markdown básico
El principal propósito de este artículo es tener a mano un resumen para los formatos básicos de markdown.
RSTUDIO pone a disposición de los usuarios una chuleta resumida muy bueno con gran parte de los formatos de sintaxis, pero creo conveniente ponerlo a mano también en el blog
Encabecados
Los encabezados se forman con con el símbolo almohadilla #
. Repitiendo este símbolo sucesivamente hacemos los encabezados o títulos cada vez más pequeños.
# Título 1
## Título 2
### Título 3
#### Título 4
##### Título 5
###### Título 6
Título 1
Título 2
Título 3
Título 4
Título 5
Título 6
Listas
Ordered List
1. Elemento 1
2. Elemento 2
3. Elemento 3
- Elemento 1
- Elemento 2
- Elemento 3
Unordered List
* Elemento 1
* Elemento 2
* Subelemento 2.1
* Elemento 3
* Subelemento 3.1
- Elemento 1
- Elemento 2
- Subelemento 2.1
- Elemento 3
- Subelemento 3.1
Bloques de código
En md para meter un bloque de código lo podemos hacer encerrando la escritura entre las los símbolos tilde 3 veces:
```
Esto es un bloque de código
```
Cuya salida es:
esto es un bloque de código
Aunque depende de la configuración local, en muchos casos puede especificarse el lenguaje a continuación de las comillas como por ejemplo aquí:
``` javascript
var s = “JavaScript syntax highlighting”;
alert(s);
```
var s = "JavaScript syntax highlighting";
alert(s);
En Rmd que es la versión adaptada de markdown que usa RSTUDIO lo haremos con el mismo símbolo y a continuación unas llaves {}
indicando dentro de la llave el lenguaje y muchos otros parámetros.
Tablas
Las tablas que no se generan dentro de código R, pueden hacerse directamente con el formato usando el símbolo |
.
| ID | Make | Model | Year |
| --- | --------- | ------- | ---- |
| 1 | Honda | Accord | 2009 |
| 2 | Toyota | Camry | 2012 |
| 3 | Hyundai | Elantra | 2010 |
resultado:
ID | Make | Model | Year |
---|---|---|---|
1 | Honda | Accord | 2009 |
2 | Toyota | Camry | 2012 |
3 | Hyundai | Elantra | 2010 |
Otro ejemplo
| Tables | Are | Cool |
|:----------- |:-------------:| ------------:|
| align: left | align: center | align: right |
| align: left | align: center | align: right |
| align: left | align: center | align: right |
se crea esto:
Tables | Are | Cool |
---|---|---|
align: left | align: center | align: right |
align: left | align: center | align: right |
align: left | align: center | align: right |
Incluso puede usarse código md dentro de la tabla:
| Inline | Markdown | In | Table |
| ---------- | --------- | ----------------- | ---------- |
| *italics* | **bold** | ~~strikethrough~~ | `code` |
Inline | Markdown | In | Table |
---|---|---|---|
italics | bold | code |
Marcas de formato
- cursiva =
*cursiva*
- negrita =
**negrita**
tachado=~~tachado~~
Enlaces
Hay varias formas de crear enlaces en md, la más simple es poner la url del enlace entre los símbolos de <>
, así <http://www.gritos.org>
cuya salida es esto http://www.gritos.org.
La otra forma es usando las llaves y paréntesis:
[texto el enlace](http://www.gritos.org)
queda así: texto el enlace
Insertar imagen
Insertar una imagen simple se hace así:
![titulo imagen](ruta/delaimagen.jpg)
En Rmd y si la salida usa $LaTeX$ podemos usar etiquetas como la siguiente:
![titulo imagen \lable{fig_23}](ruta/delaimagen.jpg)
Línea horizontal
Para insertar una linea horizontal pondremos 3 símbolos seguidos: (cualquiera de los siguientes funciona):
***
---
insertar un video de youtube
Para eso podemos insertar drectamente HTML en el código:
<a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_HERE
" target="_blank"><img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg"
alt="IMAGE ALT TEXT HERE" width="240" height="180" border="10" /></a>
Uso de $LaTeX$
Para usar código $$LaTeX$$ debemos insertar el mismo entre el símbolo de dolar $
.Por ejemplo para inserar una flecha $\rightarrow$
es $\rightarrow$.