5 ejemplos de base de conocimiento que vale la pena copiar

Estos ejemplos de base de conocimiento son cinco artículos terminados, renderizados en su totalidad en esta página y descargables como PDF: ejemplos de artículos de base de conocimiento de cara al cliente junto con ejemplos de base de conocimiento interna para una mesa de servicio y una wiki de nuevos empleados.

Ir directo a los ejemplos.

Qué hace bueno un ejemplo de base de conocimiento

• Una tarea por artículo, nombrada en el título. Se cumple: el título expone una sola tarea completable ("Restablecer el dispositivo MFA de un usuario") y el artículo termina ahí. No se cumple: el título es un tema ("Seguridad de la cuenta") que cubre tres tareas sin relación.
• Encontrable con las palabras propias del lector. Se cumple: el título repite la frase que un lector escribiría, y el artículo incluye términos alternativos para que la búsqueda lo resuelva. No se cumple: el título usa vocabulario interno, así que solo el árbol de categorías lleva hasta él.
• Prueba visual en cada punto de decisión. Se cumple: aparece una captura de pantalla en cada paso donde el lector elige entre opciones o confirma la pantalla correcta. No se cumple: los pasos se presentan como un muro de texto, o una sola captura destacada carga con todo el artículo.
• Lenguaje simple, sin jerga interna. Se cumple: el artículo expande las siglas la primera vez que aparecen y sus verbos coinciden con lo que el lector ve en pantalla. No se cumple: el artículo usa el nombre interno del equipo para una pantalla que el producto etiqueta de forma diferente.
• Un responsable con nombre y una fecha de revisión en el artículo. Se cumple: el artículo nombra a quien lo mantiene y cuándo esa persona lo revisó por última vez. No se cumple: el artículo no tiene fecha ni responsable, así que un procedimiento vigente se lee igual que uno obsoleto.
• Requisitos previos indicados y una vía de escape. Se cumple: indica qué acceso necesita el lector antes del primer paso, y qué hacer cuando los pasos no resuelven el problema. No se cumple: el lector choca con un muro de permisos en el tercer paso sin ningún lugar adonde acudir.

5 ejemplos de base de conocimiento, renderizados en su totalidad

Cada uno de estos ejemplos de artículo de base de conocimiento es un artículo completo que puedes leer de principio a fin, con su propia vista previa renderizada y su PDF. Dos son de cara al cliente, dos son ejemplos de base de conocimiento interna, y uno lo escribió una agencia para un cliente. Lee el render, toma el PDF y cambia los valores.

Ejemplo 1: Centro de ayuda de un producto SaaS (de cara al cliente)

Un equipo de contenido de soporte en un SaaS de gestión de proyectos escribió esto para un usuario final sin permisos de administrador que quiere completar una exportación sin abrir un ticket.

Qué lo hace funcionar: el título, "Cómo exportar el cronograma de tu proyecto a CSV", nombra una sola tarea completable y el artículo se detiene en cuanto llega el archivo, lo cual es "Una tarea por artículo, nombrada en el título" bien aplicado. Las capturas de pantalla están en los pasos 2 y 3, los dos únicos puntos donde el lector elige una opción, así que también cumple "Prueba visual en cada punto de decisión" sin saturar la página de imágenes.

Cuidado con: la exportación está detrás de un menú "...", y el remitente aparece como exports@[product].com, un marcador de posición. Ambos deben cambiarse por los de tu producto antes de publicar.

Descargar PDF

Ejemplo 2: Base de conocimiento interna de soporte de TI (interno)

Un agente de mesa de servicio de nivel 1 usa esto para restablecer el MFA de un usuario que llama tras cambiar de teléfono, bajo un plazo P3 con cuatro horas hábiles para resolverlo.

Qué lo hace funcionar: empieza con el acceso y los dos campos de verificación de RR. HH. que el agente necesita antes del primer paso, y cierra con "Escalar cuando", nombrando al equipo de guardia de Identidad como la salida. Eso es "Requisitos previos indicados y una vía de escape" en un artículo donde una verificación omitida es un incidente de seguridad. El bloque separado de "No hacer" mantiene las dos reglas estrictas fuera de la lista de pasos, donde se leerían como opcionales.

Cuidado con: las reglas de verificación asumen una sola consola de identidad. Un equipo con otra herramienta tiene que reescribir los pasos 2 a 5 en lugar de reutilizarlos.

Descargar PDF

Ejemplo 3: Wiki de incorporación de nuevos empleados (interno)

Un equipo de experiencia de desarrollador le entrega esto a un ingeniero nuevo el primer día, para que pueda terminar la primera semana sin interrumpir a nadie.

Qué lo hace funcionar: Sam O. es responsable del artículo y el campo de última revisión indica 2026-08-11, así que un nuevo empleado puede ver que la configuración está vigente antes de confiar en ella. Eso es "Un responsable con nombre y una fecha de revisión en el artículo", y la estimación de 90 minutos junto con el compañero designado le dicen al lector qué hacer con el tiempo y a quién preguntar.

Cuidado con: se apoya en un canal #dx-help y un compañero de incorporación asignado. Un equipo de cinco personas no tiene ninguno de los dos, así que esas dos referencias deben sustituirse por el nombre de una persona real.

Descargar PDF

Ejemplo 4: Biblioteca de solución de problemas de soporte al cliente (de cara al cliente)

Un comerciante en una plataforma de ecommerce llega a este artículo con un síntoma en lugar de una tarea: el checkout rechaza los pagos y la causa no está clara.

Qué lo hace funcionar: el título cita el síntoma con el lenguaje del comerciante, "Los pagos están fallando en el checkout", y la línea de síntoma repite el texto exacto del error que ven los clientes. La búsqueda lo resuelve con las palabras que escribe un comerciante en apuros, que es "Encontrable con las palabras propias del lector". La lista de verificación ejecuta primero la comprobación más barata, la página de estado del proveedor, antes de nada que implique un cambio de configuración.

Cuidado con: la tabla de causas y soluciones asume un solo proveedor de pagos. Una tienda con dos proveedores necesita una columna que indique cuál falló, o las filas de moneda y clave apuntarán a la cuenta equivocada.

Descargar PDF

Ejemplo 5: Base de conocimiento de traspaso de agencia a cliente (de cara al cliente)

Una agencia que cierra un proyecto escribió esto para un equipo de marketing del cliente que ahora gestiona el sitio sin acceso de desarrollador.

Qué lo hace funcionar: los pasos nombran los botones que ve el cliente, Posts, New post, Publish, y dan el tamaño de la imagen de portada como 1600x900 en lugar de "una imagen de tamaño adecuado". Eso es "Lenguaje simple, sin jerga interna" para un lector que nunca ha abierto un CMS. El bloque "No cambiar" traza el límite de alcance dentro del documento, donde el cliente lo seguirá encontrando después de que se pierda el correo de traspaso.

Cuidado con: la ventana de soporte tiene fecha 2026-11-30 y caduca el día que termina el contrato, dejando a un cliente que sigue un artículo que promete una ayuda que ya no ofreces.

Descargar PDF

Cómo adaptar un ejemplo de base de conocimiento

Toma el Ejemplo 2, el artículo interno de restablecimiento de MFA, y conviértelo en el tuyo. Cada espécimen funciona también como plantilla de partida, así que abre su PDF junto a tu editor y copia la estructura.

1. Cambia el título por una tarea que tú soportas. "Restablecer el dispositivo MFA de un usuario tras un cambio de teléfono" se convierte en el único trabajo que tu artículo resuelve, expresado como lo pediría un compañero.
2. Reescribe el bloque de campos para tu equipo. Audiencia, Responsable, Última revisión, y cualquier línea de severidad o SLA sustituyen a Marcus L. y 2026-07-22 por tus propios nombres y fechas.
3. Sustituye los requisitos previos por tus requisitos de acceso reales. Nombra la consola, el rol y las verificaciones que ocurren antes del primer paso.
4. Cambia los pasos por tu propia herramienta, manteniendo una acción por paso. Recorre la tarea una vez mientras escribes, y anota los nombres de pantalla tal como aparecen.
5. Marca los puntos de decisión que necesitan una captura de pantalla. Cualquier paso donde el lector elija entre opciones lleva una imagen al lado.
6. Elimina las secciones que tu proceso no tiene. Un artículo sin nivel de severidad descarta ese campo en lugar de dejarlo vacío.
7. Escribe la sección de fallos y la vía de escape al final. Indica qué hacer cuando los pasos dejan de funcionar, y nombra a la persona o cola que se hace cargo desde ahí.
8. Verifica el resultado contra los seis criterios anteriores por etiqueta, luego publica y fija la fecha de revisión.

Cuándo necesitas una base de conocimiento

El detonante es la misma pregunta llegando por tercera vez a tu bandeja de soporte. Liveagent reporta que el 66% de los clientes intenta resolver sus problemas antes de contactar a los equipos de atención al cliente, así que una pregunta repetida es una señal de que la respuesta existe en algún lugar privado. El Ejemplo 1, el artículo de centro de ayuda SaaS, es cómo se ve esa respuesta una vez que alguien la escribe.

Crea una cuando un nuevo empleado empieza y te descubres explicando la configuración junto a su escritorio. El Ejemplo 3, la wiki de incorporación, traslada esa explicación a un documento que el siguiente empleado puede completar solo.

Una mesa de servicio necesita una en el momento en que un procedimiento tiene un paso que un agente no puede omitir. El Ejemplo 2 existe porque leer un código en voz alta a quien llama tiene un costo, y un agente bajo un plazo de cuatro horas no debería estar reconstruyendo la regla de memoria.

Errores comunes en la base de conocimiento

• Un artículo sin responsable con nombre no se revisa. Slite estima que más del 94% del contenido de una base de conocimiento queda sin tocar en un mes cualquiera, una biblioteca en la que tus lectores dejan de confiar.
• La estructura deja de evolucionar, así que el conocimiento termina aislado. Swifteq cita un hallazgo de Gartner según el cual el 47% de los trabajadores digitales tiene problemas para encontrar la información que necesita, y una reconstrucción cuesta más que la poda que te saltaste.
• Un diseño saturado y muros de solo texto entierran la respuesta. Una página desordenada empuja el único párrafo que resuelve el problema por debajo del pliegue, y tu lector abre un ticket de todos modos.
• Sin vía de escape hacia una persona. Un lector cuyo problema sobrevive al artículo y no encuentra una vía de contacto se va sin respuesta, y tú pierdes un ticket del que podrías aprender.
• Guardar lo que no corresponde ahí. Credenciales, datos personales y cualquier cosa que no sea propiedad de tu equipo convierten un artículo de ayuda en un riesgo. La versión más común es un solo artículo que cubre tres tareas, inútil para las tres.

Sáltate la página en blanco: graba en su lugar

Cada espécimen anterior empezó alguna vez como una página en blanco. La ruta más rápida es grabar la tarea y dejar que la grabación se convierta en el artículo.

Hinto AI convierte grabaciones de pantalla y videotutoriales en documentación estructurada, SOP y centros de ayuda, para equipos que prefieren mostrar y explicar en video antes que escribir guías a mano. Graba con el grabador de pantalla integrado en el navegador o la extensión de Chrome, o trae un video que ya tengas: Loom, Zoom, YouTube o una carga local.

A partir de ahí, la detección de acciones por IA identifica los cambios de estado de la interfaz y los clics en botones dentro de la grabación, y extrae las capturas de pantalla y los pasos escritos, exactamente el tipo de lista de pasos que lleva el Ejemplo 2. Una grabación larga se convierte en una tabla de contenidos completa con varios artículos organizados, usando plantillas de centro de ayuda o SOP interno. Difumina cualquier dato sensible en el editor de imágenes, y luego aloja el resultado en una URL pública con un dominio personalizado.

Más ejemplos de base de conocimiento que vale la pena estudiar

Los especímenes anteriores están pensados para copiarse. Estos cuatro están en vivo, en producción, y responden a usuarios reales:

• Documentación de Gentler Streak, toda la base de conocimiento pública de una app de fitness, ordenada en categorías por tarea y publicada en nueve idiomas.
• Cómo iniciar un entrenamiento en tu Apple Watch, una tarea, pasos numerados, capturas de pantalla en los toques que importan.
• ¿Qué es la variabilidad de la frecuencia cardíaca (HRV)?, el tipo explicativo, que define una métrica en la que se apoyan los artículos de procedimiento.
• Versión 5.12.8 (9 de julio de 2026), notas de la versión guardadas dentro de la base de conocimiento, para que una pantalla modificada y su artículo permanezcan juntos.

Preguntas frecuentes sobre bases de conocimiento

¿Alguien conoce un lugar para encontrar plantillas y ejemplos de cómo hacer artículos de base de conocimiento con muy buen aspecto?

Usa los cinco especímenes de arriba. Cada uno se renderiza completo aquí y se descarga como PDF, así obtienes el orden de secciones y el formato de los pasos en lugar de un enlace a un centro de ayuda en vivo.

¿Cuáles son algunos buenos ejemplos de base de conocimiento?

Evalúa uno contra seis criterios: una tarea por artículo nombrada en el título, encontrable con las palabras propias del lector, prueba visual en cada punto de decisión, lenguaje simple, un responsable con nombre y una fecha de revisión, y requisitos previos indicados con una vía de escape.

¿Qué es una base de conocimiento interna y cómo crear una?

Una base de conocimiento interna atiende a los empleados en lugar de a los clientes, casi siempre para incorporación, soporte de TI y solución de problemas. Los Ejemplos 2 y 3 son especímenes internos. Empieza con los dos artículos que tu equipo explica en voz alta con más frecuencia.

¿Qué es un artículo de base de conocimiento?

Un artículo de base de conocimiento nombra una sola tarea completable en su título y termina cuando esa tarea está hecha. La forma estándar recorre título, audiencia, responsable, última revisión, requisitos previos, pasos numerados con capturas de pantalla en los puntos de decisión, una sección de fallos y una vía hacia una persona real.

¿Estos ejemplos funcionan en SharePoint, Confluence o ServiceNow?

Sí. Cada espécimen es texto estructurado simple: encabezados, un bloque de campos, pasos numerados, una tabla. No depende de ninguna función de la plataforma, así que se pega en esos editores y conserva su orden.