mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
68ac653c28
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
79 lines
3.3 KiB
Plaintext
79 lines
3.3 KiB
Plaintext
---
|
|
title: "Exportación de Markdown"
|
|
description: "Exporta versiones limpias en Markdown de tus páginas de documentación para herramientas de IA, integraciones de LLM y flujos de trabajo automatizados."
|
|
keywords: ["markdown", "eficiencia de tokens", "procesamiento de IA"]
|
|
---
|
|
|
|
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
|
|
|
Markdown proporciona texto estructurado que las herramientas de IA pueden procesar de forma más eficiente que HTML, lo que se traduce en respuestas más precisas, tiempos de procesamiento más rápidos y un menor consumo de tokens.
|
|
|
|
Mintlify genera automáticamente versiones en Markdown de las páginas optimizadas para herramientas de IA e integraciones externas.
|
|
|
|
|
|
<div id="md-url-extension">
|
|
## Extensión de URL .md
|
|
</div>
|
|
|
|
Añade `.md` a la URL de cualquier página para ver una versión en Markdown.
|
|
|
|
<PreviewButton href="https://mintlify.com/docs/ai/markdown-export.md">Abrir esta página como Markdown</PreviewButton>
|
|
|
|
<div id="accept-header">
|
|
## Encabezado Accept
|
|
</div>
|
|
|
|
Envía una solicitud con `Accept: text/markdown` o `Accept: text/plain` a la URL de cualquier página para recibir la versión Markdown en lugar de HTML. Esto es útil para herramientas de IA e integraciones que obtienen contenido de documentación de forma programática.
|
|
|
|
```bash
|
|
curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
|
|
```
|
|
|
|
<div id="audience-specific-content">
|
|
## Contenido específico por audiencia
|
|
</div>
|
|
|
|
Usa el componente [visibility](/es/components/visibility) para personalizar el contenido para audiencias humanas y de IA.
|
|
|
|
El contenido envuelto en `<Visibility for="humans">` aparece en la página web, pero no en la salida Markdown. El contenido envuelto en `<Visibility for="agents">` aparece en la salida Markdown, pero no en la página web.
|
|
|
|
```mdx
|
|
<Visibility for="humans">
|
|
Click the **Get started** button in the top-right corner to create your account.
|
|
</Visibility>
|
|
|
|
<Visibility for="agents">
|
|
To create an account, call `POST /v1/accounts` with a valid email address.
|
|
</Visibility>
|
|
```
|
|
|
|
<div id="api-reference-pages">
|
|
## Páginas de referencia de API
|
|
</div>
|
|
|
|
De forma predeterminada, las exportaciones en Markdown de las páginas de referencia de API incluyen la especificación completa de OpenAPI o AsyncAPI para que las herramientas de IA dispongan de contexto completo sobre cada endpoint.
|
|
|
|
Si prefieres omitir la especificación de la salida en Markdown, establece `markdown.schema` como `false` en tu `docs.json`:
|
|
|
|
```json
|
|
"markdown": {
|
|
"schema": false
|
|
}
|
|
```
|
|
|
|
<div id="agent-feedback">
|
|
## Comentarios de agentes
|
|
</div>
|
|
|
|
Si habilitas los [comentarios de agentes](/es/optimize/feedback#agent-feedback), Mintlify añade un bloque `<AgentInstructions>` a la exportación Markdown de cada página que indica a los agentes cómo enviar comentarios sobre el contenido de la página.
|
|
|
|
Los agentes envían comentarios publicando en el endpoint con la ruta de la página y el texto del comentario.
|
|
|
|
Usa los comentarios de agentes para mejorar tus páginas para agentes en función de lo que encuentren incorrecto, desactualizado o confuso.
|
|
|
|
<div id="keyboard-shortcut">
|
|
## Atajo de teclado
|
|
</div>
|
|
|
|
Pulsa <kbd>Command</kbd> + <kbd>C</kbd> (<kbd>Ctrl</kbd> + <kbd>C</kbd> en Windows) para copiar una página en Markdown al portapapeles.
|