# Guías (/es/guides)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 2374 · updated: 2026-07-30 -->

Las guías de esta sección contienen recomendaciones para crear documentación que ayude a tus usuarios a tener éxito. Tanto si estás empezando desde cero como si estás mejorando la documentación existente, estas guías te ayudan a planificar, redactar y mantener tu documentación.

Ante todo, ten en cuenta las necesidades y objetivos de tus usuarios. Documenta aquello que les ayude a utilizar tu producto y volver a sus tareas.

<div id="topics">
  ## Temas [#temas]
</div>

<div id="ai-tools">
  ### Herramientas de IA [#herramientas-de-ia]
</div>

Utiliza herramientas impulsadas por IA para acelerar tu flujo de trabajo de documentación.

* [Crear un assistant dentro de tu aplicación](/es/guides/assistant-embed): Tutorial que enseña cómo agregar un chat bot de IA en una app de React para ayudar a los usuarios a encontrar respuestas en tu documentación.
* [Configurar automerge](/es/guides/configure-automerge): Agrega la aplicación GitHub de Mintlify a la lista de bypass de un ruleset para habilitar la fusión automática para automatizaciones.
* [Usar automatizaciones](/es/guides/use-automations): Elige el activador de automatización adecuado, escribe instrucciones efectivas y obtén resultados consistentes del mantenimiento automatizado de contenido.
* [Claude Code](/es/guides/claude-code), [Codex](/es/guides/codex), [Cursor](/es/guides/cursor), [Devin Desktop](/es/guides/devin-desktop): Guías para usar asistentes de programación con IA para mantener la documentación.
* [GEO](/es/guides/geo): Mejores prácticas para optimizar tu documentación para motores de búsqueda y respuesta basados en IA.

<div id="api-documentation">
  ### Documentación de la API [#documentación-de-la-api]
</div>

Crea documentación de tu API que permita a los usuarios hacer pruebas y aprender a usarla, y que además sea fácil de mantener.

* [Migrar de MDX a OAS](/es/guides/migrating-from-mdx): Migra la documentación de tu API de páginas individuales en MDX a páginas autogeneradas a partir de una especificación de OpenAPI.

<div id="best-practices">
  ### Mejores prácticas [#mejores-prácticas]
</div>

Haz que tu documentación sea de primer nivel.

* [Accesibilidad](/es/guides/accessibility): Haz que tu documentación sea accesible para el mayor número posible de usuarios.
* [Tipos de contenido](/es/guides/content-types): Elige el formato adecuado para tutoriales, guías prácticas, referencias y explicaciones.
* [Plantillas de contenido](/es/guides/content-templates): Copia y modifica plantillas para cada tipo de contenido.
* [Diseños de página personalizados](/es/guides/custom-layouts): Usa modos de página y componentes para crear páginas de destino y otros diseños personalizados.
* [Mejora tu documentación](/es/guides/improving-docs): Usa datos y comentarios para mejorar tu documentación de forma continua.
* [Internacionalización](/es/guides/internationalization): Configura documentación multilingüe para llegar a una audiencia global.
* [Enlaces](/es/guides/linking): Crea enlaces internos, haz referencia a endpoints de la API y mantén la integridad de los enlaces en toda tu documentación.
* [Mantenimiento](/es/guides/maintenance): Mantén tu documentación precisa y actualizada.
* [Medios](/es/guides/media): Agrega imágenes, videos y otros medios de forma eficaz mientras gestionas la carga de mantenimiento.
* [Organiza la navegación](/es/guides/navigation): Diseña una arquitectura de la información que funcione para tus usuarios.
* [SEO](/es/guides/seo): Optimiza tu documentación para los motores de búsqueda.
* [Estilo y tono](/es/guides/style-and-tone): Escribe con una voz consistente.
* [Comprende a tu audiencia](/es/guides/understand-your-audience): Investiga y atiende las necesidades y objetivos de tus usuarios.

<div id="git-workflows">
  ### Flujos de trabajo con Git [#flujos-de-trabajo-con-git]
</div>

Entiende Git para sacar el máximo partido de Mintlify y de un enfoque de documentación como código (docs-as-code).

* [Conceptos de Git](/es/guides/git-concepts): Aprende los fundamentos de Git para la documentación.
* [Branches](/es/guides/branches): Usa branches para gestionar los cambios en la documentación.

<div id="use-cases">
  ### Casos de uso [#casos-de-uso]
</div>

Descubre cómo Mintlify se adapta a distintos casos de uso y encuentra la solución que mejor funcione para ti.

* [Crear documentación para desarrolladores](/es/guides/developer-documentation): Ayuda a tus usuarios a sacar el máximo partido de tu producto o API con documentación para desarrolladores que responda preguntas y les permita volver rápidamente a sus tareas principales.
* [Crear una base de conocimientos](/es/guides/knowledge-base): Configura una base de conocimientos interna para consolidar la información de tu equipo, mejorar las búsquedas y reducir la carga de mantenimiento.
* [Crear un centro de ayuda](/es/guides/help-center): Crea un centro de ayuda de autoservicio que permita a los usuarios encontrar respuestas por sí mismos, reduzca el volumen de tickets y mejore la satisfacción del cliente.
* [Crear un frontend personalizado](/es/guides/custom-frontend): Usa la integración de Mintlify con Astro para mostrar tu documentación con un frontend totalmente personalizado.

<div id="where-to-start">
  ## Por dónde empezar [#por-dónde-empezar]
</div>

<CardGroup cols="2">
  <Card title="¿Nuevo en la documentación?" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M8 10.1667L12.1232 6.04344C13.2481 4.91858 13.8105 4.35614 14.4312 3.90314C15.7047 2.9737 17.1818 2.36187 18.7395 2.11858C19.4988 2 20.2942 2 21.885 2C21.9681 2 22 2.03812 22 2.11504C22 3.70584 22 4.50125 21.8814 5.26046C21.6381 6.81818 21.0263 8.29527 20.0969 9.56878C19.6439 10.1895 19.0814 10.7519 17.9566 11.8768L13.8333 16&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.341 8.09838C8.63808 8.09838 6.49778 7.73765 4.9043 8.39769C3.73671 8.88132 2.87754 10.0012 2 10.8787L5.30597 12.2955C6.18208 12.671 5.64651 13.7766 5.50147 14.5018C5.33985 15.3099 5.34886 15.3397 5.93158 15.9224L8.07758 18.0684C8.6603 18.6511 8.69008 18.6602 9.49816 18.4985C10.2234 18.3535 11.329 17.8179 11.7044 18.694L13.1213 22C13.9988 21.1225 15.1187 20.2633 15.6023 19.0957C16.2624 17.5022 15.9016 15.3619 15.9016 13.659&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12 20L11 21&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M4 12L3 13&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15 4.07996C16.2 4.25996 17.46 4.73996 18.1614 5.45996C19.0576 6.25211 19.68 7.31996 19.92 8.99996&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;square&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M17.94 6.06006L16.5 7.50006&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/es/guides/content-types">
    Aprende acerca de los tipos de contenido para entender cómo estructurar tu documentación.
  </Card>

  <Card title="¿Mejorando la documentación existente?" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M7 15.2461L9.87381 11.5319C10.1242 11.2082 10.2495 11.0464 10.3862 10.9354C10.7975 10.6017 11.3471 10.5135 11.8368 10.7026C11.9997 10.7654 12.1664 10.8804 12.5 11.1103C12.8336 11.3402 13.0003 11.4552 13.1632 11.518C13.6529 11.7071 14.2025 11.6189 14.6138 11.2852C14.7505 11.1742 14.8757 11.0124 15.1262 10.6887L15.9061 9.68068C16.8833 8.41772 17.3719 7.78624 18.0414 7.7479C18.7109 7.70956 19.264 8.28139 20.3701 9.42505L21 10.0764&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21 21H10C6.70017 21 5.05025 21 4.02513 19.9749C3 18.9497 3 17.2998 3 14V3&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/es/guides/improving-docs">
    Aprende a usar métricas y comentarios para mejorar tu documentación.
  </Card>

  <Card title="¿Trabajando con un equipo?" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M7 20C8.10457 20 9 19.1046 9 18C9 16.8954 8.10457 16 7 16C5.89543 16 5 16.8954 5 18C5 19.1046 5.89543 20 7 20Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7 8C8.10457 8 9 7.10457 9 6C9 4.89543 8.10457 4 7 4C5.89543 4 5 4.89543 5 6C5 7.10457 5.89543 8 7 8Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M17 14C18.1046 14 19 13.1046 19 12C19 10.8954 18.1046 10 17 10C15.8954 10 15 10.8954 15 12C15 13.1046 15.8954 14 17 14Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7.02116 8.2793V15.4073M14.4113 12.0047L10.0193 12.0048C8.92158 12.0048 6.86182 11.1254 7.01818 8.78001&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/es/guides/git-concepts">
    Aprende flujos de trabajo de Git para documentación colaborativa.
  </Card>
</CardGroup>