Exportación de Markdown

Exporta versiones limpias en Markdown de tus páginas de documentación para herramientas de IA, integraciones de LLM y flujos de trabajo automatizados.

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.

​

Extensión de URL .md

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

​

Encabezado Accept

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 -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export

​

Contenido específico por audiencia

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>

​

Páginas de referencia de API

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
}

​

Comentarios de agentes

Si habilitas los comentarios de agentes, 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.

​

Atajo de teclado

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