Guía de Estilo Markdown

4 min

Aquí hay algunos ejemplos básicos de sintaxis Markdown y sus efectos estilísticos en el tema Retypeset.

Encabezados

Para crear un encabezado, agregue signos de numeral # delante de una palabra o frase. El número de signos de numeral debe corresponder al nivel del encabezado.

Sintaxis

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

Resultado

Encabezado 1

Encabezado 2

Encabezado 3

Encabezado 4

Encabezado 5
Encabezado 6

Párrafos

Para crear párrafos, use una línea en blanco para separar una o más líneas de texto.

Sintaxis

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

Resultado

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

Imágenes

Para agregar una imagen, añada un signo de exclamación !, seguido de texto alternativo entre corchetes [], y la ruta o URL de la imagen entre paréntesis ().

Sintaxis

![Descripción de la Imagen](./full/or/relative/path/of/image)

Resultado

Descripción de la Imagen

Citas en Bloque

Para crear una cita en bloque, agregue un > delante de un párrafo. Para crear una cita en bloque con múltiples párrafos, agregue un símbolo > en las líneas en blanco entre los párrafos. Para citar fuentes, puede usar las etiquetas <cite> o <footer> para referencias bibliográficas, mientras que las notas al pie pueden insertarse usando la sintaxis [^1] o [^note].

Cita en bloque con múltiples párrafos

Sintaxis

> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
>
> **Nota** que puede usar _sintaxis Markdown_ dentro de una cita en bloque.

Resultado

Tiam, ad mint andaepu dandae nostion secatur sequo quae.

Nota que puede usar sintaxis Markdown dentro de una cita en bloque.

Cita en bloque con fuentes citadas

Sintaxis

> No te comuniques compartiendo memoria, comparte memoria comunicándote.
>
> — <cite>Rob Pike[^1]</cite>

[^1]: La cita anterior está extraída de la [charla](https://www.youtube.com/watch?v=PAAkCSZUG1c) de Rob Pike durante Gopherfest, 18 de noviembre de 2015.

Resultado

No te comuniques compartiendo memoria, comparte memoria comunicándote.

Rob Pike1

Tablas

Para agregar una tabla, use tres o más guiones --- para crear el encabezado de cada columna, y use barras verticales | para separar cada columna.

Sintaxis

| Cursiva   | Negrita     | Código   |
| --------- | ----------- | -------- |
| _cursiva_ | **negrita** | `código` |
| _cursiva_ | **negrita** | `código` |

Resultado

CursivaNegritaCódigo
cursivanegritacódigo
cursivanegritacódigo

Bloques de Código

Para crear un bloque de código, agregue tres acentos graves ``` al inicio y al final de su código. Puede indicar el lenguaje de programación después de los acentos graves de apertura para indicar cómo colorear y estilizar su código, por ejemplo: html, javascript, css, markdown, etc.

Sintaxis

```html
<!doctype html>
<html lang="es">
  <head>
    <meta charset="utf-8" />
    <title>Ejemplo de Documento HTML5</title>
  </head>
  <body>
    <p>Prueba</p>
  </body>
</html>
```

Resultado

<!doctype html>
<html lang="es">
  <head>
    <meta charset="utf-8" />
    <title>Ejemplo de Documento HTML5</title>
  </head>
  <body>
    <p>Prueba</p>
  </body>
</html>

Tipos de Listas

Lista Ordenada

Sintaxis

1. Primer elemento
2. Segundo elemento
3. Tercer elemento

Resultado

  1. Primer elemento
  2. Segundo elemento
  3. Tercer elemento

Lista No Ordenada

Sintaxis

- Elemento de lista
- Elemento gráfico
- Y otro elemento

Resultado

  • Elemento de lista
  • Elemento gráfico
  • Y otro elemento

Lista Anidada

Sintaxis

- Frutas
  - Manzana
  - Naranja
  - Plátano
- Lácteos
  - Leche
  - Queso

Resultado

  • Frutas
    • Manzana
    • Naranja
    • Plátano
  • Lácteos
    • Leche
    • Queso

Otros Elementos

Incluyendo superíndice <sup>, subíndice <sub>, abreviatura <abbr>, tachado <del>, subrayado ondulado <u>, entrada de teclado <kbd> y resaltado <mark>.

Sintaxis

H<sub>2</sub>O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

<abbr title="Graphics Interchange Format">GIF</abbr> es un formato de imagen de mapa de bits.

Los buenos escritores siempre revisan la <u title="ortografía">ortografia</u>.

Presione <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Suprimir</kbd> para finalizar la sesión.

No hay <del>nada</del> ningún código que sea bueno o malo, pero ejecutarlo lo hace así.

La mayoría de las <mark>salamandras</mark> son nocturnas y cazan insectos, gusanos y otras criaturas pequeñas.

Resultado

H2O

Xn + Yn = Zn

GIF es un formato de imagen de mapa de bits.

Los buenos escritores siempre revisan la ortografia.

Presione CTRL + ALT + Suprimir para finalizar la sesión.

No hay nada ningún código que sea bueno o malo, pero ejecutarlo lo hace así.

La mayoría de las salamandras son nocturnas y cazan insectos, gusanos y otras criaturas pequeñas.

Footnotes

  1. La cita anterior está extraída de la charla de Rob Pike durante Gopherfest, 18 de noviembre de 2015.