> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recorrido por los componentes

> Un recorrido por los componentes que puedes usar en cualquier página de Mintlify.

Cada ejemplo a continuación es MDX real. Abre la opción **View as Markdown** de la página para copiar cualquiera de ellos.

## Avisos

> [!NOTE]
>
> Una **nota** agrega contexto adicional.

> [!TIP]
>
> Un **consejo** comparte un atajo o una buena práctica.

> [!NOTE]
>
> Un aviso de **información** destaca contexto útil.

> [!TIP]
>
> Una **confirmación** indica que algo salió bien.

> [!WARNING]
>
> Una **advertencia** señala algo con lo que hay que tener cuidado.

> [!CAUTION]
>
> Un aviso de **peligro** marca algo que puede romper cosas.

## Tarjetas

> [card] Tarjeta simple
>
> Una tarjeta con un icono y texto.

> [card] [Tarjeta con enlace](https://docs.marcodewey.com/es/quickstart.md)
>
> Agrega `href` y toda la tarjeta se puede pulsar.

> [card] [Tarjeta con CTA](https://docs.marcodewey.com/es/changelog.md)
>
> Agrega `cta` para una etiqueta de enlace personalizada.

> [card] Tarjeta horizontal
>
> Usa `horizontal` para un diseño compacto de ancho completo.

## Columnas

> [card] Columna izquierda
>
> Las columnas organizan cualquier cosa en una cuadrícula adaptable.

> [card] Columna derecha
>
> Se apilan en pantallas pequeñas.

## Pasos

**1. Primer paso**

Los pasos numeran un procedimiento automáticamente.

**2. Segundo paso**

Coloca cualquier contenido en un paso, incluido código:

```bash theme={null}
echo "hello from a step"
```

**3. Tercer paso**

Listo.

## Pestañas

> [tab] Primera pestaña
>
> Las pestañas alternan entre opciones, como sistemas operativos o lenguajes.

> [tab] Segunda pestaña
>
> La elección del lector se recuerda en las páginas que usan los mismos títulos de pestaña.

## Grupos de código y bloques de código

```python Python theme={null}
def greet(name: str) -> str:
    return f"Hello, {name}!"
```

```javascript JavaScript theme={null}
const greet = (name) => `Hello, ${name}!`;
```

```go Go theme={null}
func greet(name string) string { return "Hello, " + name + "!" }
```

```python title="highlight.py" lines highlight={2,3} theme={null}
def total(items):
    subtotal = sum(items)       # highlighted
    return subtotal * 1.08      # highlighted
```

## Acordeones

> [accordion] Cerrado por defecto
>
> Los acordeones ocultan detalles hasta que el lector los quiere ver.

> [accordion] Abierto por defecto
>
> Establece `defaultOpen` para que empiece expandido.

## Diagramas con Mermaid

Escribe un bloque delimitado `mermaid` y Mintlify lo renderiza, en modo claro y oscuro.

```mermaid theme={null}
sequenceDiagram
    participant Reader as Lector
    participant Docs as Documentación de Mintlify
    participant API as Tu API
    Reader->>Docs: Abre una página de endpoint
    Docs->>Reader: Muestra el generador de solicitudes y ejemplos de código
    Reader->>API: Hace clic en "Try it"
    API-->>Reader: 200 OK con JSON
```

Los diagramas de flujo funcionan de la misma manera.

```mermaid theme={null}
flowchart LR
    Idea[Idea] --> Draft[Borrador] --> Review[Revisión] --> Publish[Publicación]
    Review -- cambios solicitados --> Draft
```

## Campos de API

**user\_id** `string` *required*

El ID del usuario. Los parámetros de ruta, los parámetros de consulta, los encabezados y los campos del cuerpo tienen cada uno su propia variante.

**limit** `integer` (default: 10)

Número máximo de resultados.

**user** `object` *required*

El objeto de usuario.

**propiedades**

**name** `string`

El nombre del usuario.

**plan** `string` (default: free)

El plan del usuario.

## Ejemplos de solicitud y respuesta

```bash Request theme={null}
curl https://api.example.com/users/42
```

```json Response theme={null}
{ "user": { "name": "Ada", "plan": "free" } }
```

## Marcos e imágenes

![Logotipo de Mintlify Demo](https://mintcdn.com/mintlify-demo/ftr7TwW1rIS6Qhdf/logo/light.svg?fit=max\&auto=format\&n=ftr7TwW1rIS6Qhdf\&q=85\&s=62ba26dbb685fbe98c75fe4055da1835)

Una imagen SVG dentro de un Frame, con una leyenda.

## Insignias, tooltips e iconos

EstableBetaObsoletoContornoPíldora

Pasa el cursor sobre OpenAPI (Un formato estándar para describir APIs HTTP. Mintlify lo convierte en una referencia de API interactiva.) para ver un tooltip.

Iconos en línea:  &#x20;

## Árbol

**merge-sort-api**

**main.py**

**requirements.txt**

**tests**

**test\_main.py**

**docs**

**docs.json**

**index.mdx**

**openapi.json**

## Colores

**primary** `#0D9373`

**light** `#55D799`

**surface** `#F8FAFC` (light), `#0F172A` (dark)

## Tarjeta de repositorio de GitHub

## Prompt

Dale esto a tu agente de programación para que escriba documentación con tu estilo.

Eres un redactor técnico. Escribe documentación clara y concisa para desarrolladores.

* Usa la segunda persona ("tú") y verbos en voz activa.
* Comienza cada procedimiento con un encabezado orientado a un objetivo.
* Muestra un ejemplo de código ejecutable para cada endpoint.

## Vistas

**Python**

```python theme={null}
print("Views switch the content for the whole page.")
```

**JavaScript**

```javascript theme={null}
console.log("Pick a language and the page changes.");
```

## Matemáticas

Matemáticas en línea como $E = mc^2$ y matemáticas en bloque:

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

## Tablas y Markdown

| Función | Free | Pro | Enterprise |
| - | :-: | :-: | :-: |
| Alojamiento de documentación | Sí | Sí | Sí |
| Asistente de IA | | Sí | Sí |
| Proyectos multirrepositorio | | | Sí |

> Las citas en bloque, la **negrita**, la *cursiva*, el ~~tachado~~, el `código en línea` y los [enlaces](https://docs.marcodewey.com/es/quickstart.md) funcionan como esperarías.

* [x] Las listas de tareas
* [ ] también funcionan

> [!NOTE]
>
> Un **Panel** fija contenido en el lado derecho de la página. Úsalo para ejemplos, resúmenes o enlaces.
