Exportación de Markdown

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.

Añade .md a la URL de cualquier página para ver una versión en Markdown.

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.

curl -L -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export

Si solicitas en Markdown una página que no existe, Mintlify devuelve un estado 404 con un cuerpo Markdown que ayuda a las herramientas de IA a recuperarse. La respuesta enlaza al índice de tu documentación (llms.txt), a tu archivo de documentación completa (llms-full.txt) y hasta a tres páginas relacionadas según la ruta solicitada.

> ## Documentation Index
> Fetch the documentation index at: https://example.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For broader context, fetch the full documentation at: https://example.com/docs/llms-full.txt (large file).

# Page Not Found

The requested page could not be found.

## Related topics

- [Getting started](https://example.com/docs/getting-started.md)

Las sugerencias de páginas relacionadas provienen de la misma búsqueda que impulsa la página 404 de tu sitio. Los sitios que usan autenticación omiten las sugerencias y devuelven solo los enlaces de documentación.

Usa el componente 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.

<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>

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:

"markdown": {
  "schema": false
}

Para añadir tus propias indicaciones al Markdown que Mintlify sirve a los agentes de IA, establece markdown.instructions en tu docs.json. Úsalo para directrices a nivel de sitio como citar una versión de la API, preferir un SDK específico o seguir tu terminología.

Proporciona una sola cadena:

"markdown": {
  "instructions": "Always cite the API version. Prefer the TypeScript SDK in examples."
}

O un arreglo de cadenas, que Mintlify une con saltos de línea:

"markdown": {
  "instructions": [
    "Always cite the API version.",
    "Prefer the TypeScript SDK in examples."
  ]
}

Mintlify renderiza tus instrucciones como un bloque Agent Instructions en la salida Markdown:

> ## Agent Instructions
> Always cite the API version.
> Prefer the TypeScript SDK in examples.

El bloque aparece en:

• La exportación en Markdown de cada página, incluidas las páginas de referencia de API.
• Tu archivo llms.txt, después del título y la descripción del sitio.
• Tu archivo llms-full.txt.

Estas instrucciones se aplican a todas las páginas. Para adaptar el contenido a una única página o audiencia, usa el componente visibility en su lugar.

La exportación de Markdown respeta las mismas reglas de autenticación que la versión HTML de cada página.

Pulsa Cmd + C (Ctrl + C en Windows) para copiar una página en Markdown al portapapeles.