chore: update i18n md style guide articles

This commit is contained in:
radishzzz 2025-03-24 21:27:36 +00:00
parent ece7351668
commit e3730749de
8 changed files with 424 additions and 300 deletions

View file

@ -8,25 +8,45 @@ lang: es
abbrlink: markdown-style-guide
---
Aquí hay una muestra de sintaxis básica de Markdown que se puede utilizar al escribir contenido en Retypeset.
Aquí hay algunos ejemplos básicos de sintaxis Markdown y sus efectos estilísticos en el tema Retypeset.
## Encabezados
Los siguientes elementos HTML `<h1>``<h6>` representan seis niveles de encabezados de sección. `<h1>` es el nivel de sección más alto mientras que `<h6>` es el más bajo.
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árrafo
## 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.
@ -34,6 +54,8 @@ Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sap
## 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
```markdown
@ -44,48 +66,57 @@ Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sap
![Descripción de la Imagen](/image-placeholder)
## Citas en bloque
## Citas en Bloque
El elemento de cita en bloque representa contenido citado de otra fuente, opcionalmente con una cita que debe estar dentro de un elemento `footer` o `cite`, y opcionalmente con cambios en línea como anotaciones y abreviaturas.
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 sin atribución
### Cita en bloque con múltiples párrafos
#### Sintaxis
```markdown
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.<br>
> **Nota** que puedes usar _sintaxis Markdown_ dentro de una cita en bloque.
> 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.<br>
> **Nota** que puedes usar _sintaxis Markdown_ dentro de una cita en bloque.
> 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 atribución
### Cita en bloque con fuentes citadas
#### Sintaxis
```markdown
> No te comuniques compartiendo memoria, comparte memoria comunicándote.<br>
> 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.<br>
> No te comuniques compartiendo memoria, comparte memoria comunicándote.
>
> — <cite>Rob Pike[^1]</cite>
[^1]: La cita anterior es un extracto de la [charla](https://www.youtube.com/watch?v=PAAkCSZUG1c) de Rob Pike durante Gopherfest, 18 de noviembre de 2015.
[^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
@ -93,10 +124,11 @@ El elemento de cita en bloque representa contenido citado de otra fuente, opcion
| Cursiva | Negrita | Código |
| --------- | ----------- | -------- |
| _cursiva_ | **negrita** | `código` |
| _cursiva_ | **negrita** | `código` |
## Bloques de Código
Podemos usar 3 comillas invertidas ``` en una nueva línea, escribir el fragmento y cerrar con 3 comillas invertidas en una nueva línea. Para resaltar la sintaxis específica del lenguaje, escriba una palabra del nombre del lenguaje después de las primeras 3 comillas invertidas, por ejemplo, html, javascript, css, markdown, typescript, txt, bash.
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
@ -154,15 +186,15 @@ Podemos usar 3 comillas invertidas ``` en una nueva línea, escribir el fragment
```markdown
- Elemento de lista
- Otro elemento
- Y otro elemento más
- Elemento gráfico
- Y otro elemento
```
#### Resultado
- Elemento de lista
- Otro elemento
- Y otro elemento más
- Elemento gráfico
- Y otro elemento
### Lista Anidada
@ -190,7 +222,7 @@ Podemos usar 3 comillas invertidas ``` en una nueva línea, escribir el fragment
## Otros Elementos
Incluyen superíndice `<sup>`, subíndice `<sub>`, abreviatura `<abbr>`, tachado `<del>`, subrayado ondulado `<u>`, entrada de teclado `<kbd>` y resaltado `<mark>`.
Incluyendo superíndice `<sup>`, subíndice `<sub>`, abreviatura `<abbr>`, tachado `<del>`, subrayado ondulado `<u>`, entrada de teclado `<kbd>` y resaltado `<mark>`.
### Sintaxis
@ -203,7 +235,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
Los buenos escritores siempre revisan la <u title="ortografía">ortografia</u>.
Presiona <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Suprimir</kbd> para finalizar la sesión.
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í.
@ -220,7 +252,7 @@ X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
Los buenos escritores siempre revisan la <u title="ortografía">ortografia</u>.
Presiona <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Suprimir</kbd> para finalizar la sesión.
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í.