mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
b9bb94f159
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
278 lines
7.3 KiB
Plaintext
278 lines
7.3 KiB
Plaintext
---
|
|
title: "Dar formato al texto"
|
|
description: "Aprende a dar formato al texto, crear encabezados y dar estilo al contenido."
|
|
keywords: ["Markdown formatting", "text styling", "headers", "anchor links"]
|
|
---
|
|
|
|
<div id="headers">
|
|
## Encabezados
|
|
</div>
|
|
|
|
Los encabezados organizan tu contenido y crean anclajes de navegación. Aparecen en la tabla de contenidos y ayudan a los usuarios a explorar tu documentación.
|
|
|
|
<div id="creating-headers">
|
|
### Creación de encabezados
|
|
</div>
|
|
|
|
Usa los símbolos `#` para crear encabezados de distintos niveles:
|
|
|
|
```mdx
|
|
## Encabezado de sección principal
|
|
### Encabezado de subsección
|
|
#### Encabezado de sub-subsección
|
|
```
|
|
|
|
<Tip>
|
|
Utiliza encabezados descriptivos, con palabras clave, que indiquen claramente el contenido que sigue. Esto mejora la navegación del usuario y el posicionamiento en buscadores.
|
|
</Tip>
|
|
|
|
<div id="disabling-anchor-links">
|
|
### Desactivar enlaces de anclaje
|
|
</div>
|
|
|
|
De forma predeterminada, los encabezados incluyen enlaces de anclaje en los que se puede hacer clic que permiten a los usuarios enlazar directamente a secciones específicas. Puedes desactivar estos enlaces de anclaje usando la prop `noAnchor` en encabezados HTML o React.
|
|
|
|
<CodeGroup>
|
|
```mdx HTML header example
|
|
<h2 noAnchor>
|
|
Encabezado sin enlace de anclaje
|
|
</h2>
|
|
```
|
|
|
|
```mdx React header example
|
|
<Heading level={2} noAnchor>
|
|
Encabezado sin enlace de anclaje
|
|
</Heading>
|
|
```
|
|
</CodeGroup>
|
|
|
|
Cuando se usa `noAnchor`, el encabezado no mostrará la “píldora” de anclaje y, al hacer clic en el texto del encabezado, no se copiará el enlace de anclaje al portapapeles.
|
|
|
|
<div id="text-formatting">
|
|
## Formato de texto
|
|
</div>
|
|
|
|
Compatible con la mayoría del formato de Markdown para resaltar y dar estilo al texto.
|
|
|
|
<div id="basic-formatting">
|
|
### Formato básico
|
|
</div>
|
|
|
|
Aplica estos estilos de formato a tu texto:
|
|
|
|
| Estilo | Sintaxis | Ejemplo | Resultado |
|
|
|-------|--------|---------|--------|
|
|
| **Negrita** | `**text**` | `**nota importante**` | **nota importante** |
|
|
| *Cursiva* | `_text_` | `_énfasis_` | *énfasis* |
|
|
| ~~Tachado~~ | `~text~` | `~función en desuso~` | ~~función en desuso~~ |
|
|
|
|
<div id="combining-formats">
|
|
### Combinar formatos
|
|
</div>
|
|
|
|
Puedes combinar estilos de formato:
|
|
|
|
```mdx
|
|
**_negrita y cursiva_**
|
|
**~~negrita y tachado~~**
|
|
*~~cursiva y tachado~~*
|
|
```
|
|
|
|
***negrita y cursiva***<br />
|
|
**~~negrita y tachado~~**<br />
|
|
*~~cursiva y tachado~~*
|
|
|
|
<div id="superscript-and-subscript">
|
|
### Superíndice y subíndice
|
|
</div>
|
|
|
|
Para expresiones matemáticas o notas al pie, usa etiquetas HTML:
|
|
|
|
| Tipo | Sintaxis | Ejemplo | Resultado |
|
|
|------|--------|---------|--------|
|
|
| Superíndice | `<sup>text</sup>` | `example<sup>2</sup>` | example<sup>2</sup> |
|
|
| Subíndice | `<sub>text</sub>` | `example<sub>n</sub>` | example<sub>n</sub> |
|
|
|
|
<div id="links">
|
|
## Enlaces
|
|
</div>
|
|
|
|
Los enlaces ayudan a los usuarios a navegar entre páginas y acceder a recursos externos. Usa texto de enlace descriptivo para mejorar la accesibilidad y la experiencia del usuario.
|
|
|
|
<div id="internal-links">
|
|
### Enlaces internos
|
|
</div>
|
|
|
|
Enlaza a otras páginas de tu documentación usando rutas relativas a la raíz:
|
|
|
|
```mdx
|
|
[Inicio rápido](/quickstart)
|
|
[Pasos](/components/steps)
|
|
```
|
|
|
|
[Guía rápida](/es/quickstart)<br />
|
|
[Pasos](/es/components/steps)
|
|
|
|
<div id="external-links">
|
|
### Enlaces externos
|
|
</div>
|
|
|
|
Para los recursos externos, incluye la URL completa:
|
|
|
|
```mdx
|
|
[Guía de Markdown](https://www.markdownguide.org/)
|
|
```
|
|
|
|
[Guía de Markdown](https://www.markdownguide.org/)
|
|
|
|
<div id="broken-links">
|
|
### Enlaces rotos
|
|
</div>
|
|
|
|
Puedes comprobar si hay enlaces rotos en tu documentación usando la [CLI](/es/installation):
|
|
|
|
```bash
|
|
mint enlaces-rotos
|
|
```
|
|
|
|
<div id="blockquotes">
|
|
## Citas en bloque
|
|
</div>
|
|
|
|
Las citas en bloque destacan información importante, citas o ejemplos dentro de tu contenido.
|
|
|
|
<div id="single-line-blockquotes">
|
|
### Citas en bloque de una sola línea
|
|
</div>
|
|
|
|
Agrega `>` antes del texto para crear una cita en bloque:
|
|
|
|
```mdx
|
|
> Esta es una cita que se destaca del contenido principal.
|
|
```
|
|
|
|
> Esta es una cita que destaca del contenido principal.
|
|
|
|
<div id="multi-line-blockquotes">
|
|
### Citas en bloque de varias líneas
|
|
</div>
|
|
|
|
Para citas largas o de varios párrafos:
|
|
|
|
```mdx
|
|
> Este es el primer párrafo de una cita en bloque de múltiples líneas.
|
|
>
|
|
> Este es el segundo párrafo, separado por una línea vacía con `>`.
|
|
```
|
|
|
|
> Este es el primer párrafo de una cita en bloque de varias líneas.
|
|
>
|
|
> Este es el segundo párrafo, separado por una línea en blanco con `>`.
|
|
|
|
<Tip>
|
|
Usa las citas en bloque con moderación para mantener su impacto visual y su significado. Considera usar [llamadas](/es/components/callouts) para notas, advertencias y otra información.
|
|
</Tip>
|
|
|
|
<div id="mathematical-expressions">
|
|
## Expresiones matemáticas
|
|
</div>
|
|
|
|
Ofrecemos compatibilidad con LaTeX para representar expresiones y ecuaciones matemáticas. Puedes anular la detección automática configurando `styles.latex` en `docs.json` en tus [ajustes](/es/organize/settings#param-latex).
|
|
|
|
<div id="inline-math">
|
|
### Matemáticas en línea
|
|
</div>
|
|
|
|
Usa un solo signo de dólar, `$`, para expresiones matemáticas en línea:
|
|
|
|
```mdx
|
|
El teorema de Pitágoras establece que $(a^2 + b^2 = c^2)$ en un triángulo rectángulo.
|
|
```
|
|
|
|
El teorema de Pitágoras establece que $(a^2 + b^2 = c^2)$ en un triángulo rectángulo.
|
|
|
|
<div id="block-equations">
|
|
### Ecuaciones en bloque
|
|
</div>
|
|
|
|
Usa dos signos de dólar, `$$`, para ecuaciones en bloque:
|
|
|
|
```mdx
|
|
$$
|
|
E = mc^2
|
|
$$
|
|
```
|
|
|
|
$$
|
|
E = mc^2
|
|
$$
|
|
|
|
<Info>
|
|
La compatibilidad con LaTeX requiere una sintaxis matemática correcta. Consulta la [documentación de LaTeX](https://www.latex-project.org/help/documentation/) para obtener pautas completas sobre la sintaxis.
|
|
</Info>
|
|
|
|
<div id="line-breaks-and-spacing">
|
|
## Saltos de línea y espaciado
|
|
</div>
|
|
|
|
Controla los saltos de línea y el espaciado para mejorar la legibilidad del contenido.
|
|
|
|
<div id="paragraph-breaks">
|
|
### Saltos de párrafo
|
|
</div>
|
|
|
|
Separe los párrafos con líneas en blanco:
|
|
|
|
```mdx
|
|
Este es el primer párrafo.
|
|
|
|
Este es el segundo párrafo, separado por una línea en blanco.
|
|
```
|
|
|
|
Este es el primer párrafo.
|
|
|
|
Este es el segundo párrafo, separado por una línea en blanco.
|
|
|
|
<div id="manual-line-breaks">
|
|
### Saltos de línea manuales
|
|
</div>
|
|
|
|
Usa etiquetas HTML `<br />` para forzar saltos de línea dentro de párrafos:
|
|
|
|
```mdx
|
|
Esta línea termina aquí.<br />
|
|
Esta línea comienza en una nueva línea.
|
|
```
|
|
|
|
Esta línea termina aquí.<br />
|
|
Esta línea comienza en una línea nueva.
|
|
|
|
<Tip>
|
|
En la mayoría de los casos, separar los párrafos con líneas en blanco ofrece mejor legibilidad que insertar saltos de línea manuales.
|
|
</Tip>
|
|
|
|
<div id="best-practices">
|
|
## Buenas prácticas
|
|
</div>
|
|
|
|
<div id="content-organization">
|
|
### Organización del contenido
|
|
</div>
|
|
|
|
* Usa encabezados para crear una jerarquía de contenido clara
|
|
* Respeta la jerarquía correcta de encabezados (no saltes de H2 a H4)
|
|
* Escribe encabezados descriptivos con palabras clave
|
|
|
|
<div id="text-formatting">
|
|
### Formato de texto
|
|
</div>
|
|
|
|
* Usa la negrita para enfatizar, no para párrafos completos
|
|
* Reserva la cursiva para términos, títulos o un énfasis sutil
|
|
* Evita el exceso de formato que distraiga del contenido
|
|
|
|
### Enlaces
|
|
|
|
* Escribe texto de enlace descriptivo en lugar de “haz clic aquí” o “leer más”
|
|
* Usa rutas relativas a la raíz para los enlaces internos
|
|
* Revisa los enlaces con regularidad para evitar referencias rotas |