mirror of
https://github.com/reonokiy/blog.nokiy.net.git
synced 2025-06-16 03:32:51 +02:00
263 lines
7.3 KiB
Markdown
263 lines
7.3 KiB
Markdown
---
|
|
title: Guía de Estilo Markdown
|
|
published: 2025-03-08
|
|
updated: 2025-03-23
|
|
tags:
|
|
- Guía
|
|
pin: 98
|
|
toc: false
|
|
lang: es
|
|
abbrlink: markdown-style-guide
|
|
---
|
|
|
|
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
|
|
|
|
```
|
|
|
|
|
|
|
|
```
|
|
|
|
### Resultado
|
|
|
|
|
|
|
|
## 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
|
|
|
|
```markdown
|
|
> 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
|
|
|
|
```markdown
|
|
> 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.
|
|
>
|
|
> — <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.
|
|
|
|
## 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
|
|
|
|
```markdown
|
|
| Cursiva | Negrita | Código |
|
|
| --------- | ----------- | -------- |
|
|
| _cursiva_ | **negrita** | `código` |
|
|
| _cursiva_ | **negrita** | `código` |
|
|
```
|
|
|
|
### Resultado
|
|
|
|
| Cursiva | Negrita | Código |
|
|
| --------- | ----------- | -------- |
|
|
| _cursiva_ | **negrita** | `código` |
|
|
| _cursiva_ | **negrita** | `có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
|
|
|
|
````markdown
|
|
```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
|
|
|
|
```html
|
|
<!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
|
|
|
|
```markdown
|
|
1. Primer elemento
|
|
2. Segundo elemento
|
|
3. Tercer elemento
|
|
```
|
|
|
|
#### Resultado
|
|
|
|
1. Primer elemento
|
|
2. Segundo elemento
|
|
3. Tercer elemento
|
|
|
|
### Lista No Ordenada
|
|
|
|
#### Sintaxis
|
|
|
|
```markdown
|
|
- Elemento de lista
|
|
- Elemento gráfico
|
|
- Y otro elemento
|
|
```
|
|
|
|
#### Resultado
|
|
|
|
- Elemento de lista
|
|
- Elemento gráfico
|
|
- Y otro elemento
|
|
|
|
### Lista Anidada
|
|
|
|
#### Sintaxis
|
|
|
|
```markdown
|
|
- 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
|
|
|
|
```html
|
|
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
|
|
|
|
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.
|