Los hipervínculos son una de las herramientas más potentes en la documentación técnica. Si se hacen bien, reducen la fricción para los lectores, mantienen tu contenido interconectado y mejoran el rendimiento de tu Knowledge base en la búsqueda. Si se hacen mal, crean callejones sin salida, experiencias rotas y usuarios frustrados.
En Document360, puedes añadir hipervínculos a texto, imágenes y archivos dentro de tus artículos o páginas de categoría, enlazando a contenido relacionado, recursos externos o secciones específicas dentro del mismo artículo. Por ejemplo, si estás escribiendo una guía de instalación de software, un hipervínculo a la página de descarga ahorra a tus lectores tener que buscarla por sí mismos.
Este artículo cubre todo lo que necesitas saber sobre cómo añadir, gestionar y optimizar hipervínculos en Document360, tanto en el Markdown como Advanced WYSIWYG editor.
Por qué importan los hipervínculos en una base de conocimiento
Antes de profundizar en el cómo, merece la pena entender el porqué.
Para los lectores, los hipervínculos significan que nunca tienen que salir a mitad de la tarea para buscar información relacionada. Si un usuario está leyendo tu guía "Cómo empezar" y necesita entender la autenticación de la API, un hipervínculo le lleva allí al instante, sin buscar ni cambiar de contexto.
Para tu base de conocimientos, una estructura bien enlazada indica a los motores de búsqueda (y sistemas de IA) que tu contenido es autoritario, organizado y completo. Esto impacta directamente en SEO (cómo posicionan tus artículos en Google), AEO (Optimización para Motores de Respuesta, con qué frecuencia los asistentes de IA citan tu contenido) y GEO (Optimización para Motores Generativos, ya sea que herramientas como ChatGPT, Perplexity o Claude utilicen tu contenido como fuente).
Para tu equipo de soporte, los hipervínculos entre artículos relacionados reducen preguntas repetitivas. En lugar de reescribir la misma explicación en cinco artículos, la escribes una vez y enlazas a todas partes.
Para los mantenedores de contenido, los enlaces ancla y los IDs de encabezado persistentes permiten reestructurar los artículos sin romper todos los enlaces que apuntan a ellos.
Tipos de hipervínculos que puedes crear en Document360
Document360 soporta cuatro tipos principales de hipervínculos, cada uno con un propósito diferente:
Tipo de enlace | Mejor usado para |
|---|---|
Enlace interno del artículo | Conectar temas relacionados a través de tu base de conocimientos |
Enlace de cabecera/ancla | Enlazamiento profundo a una sección específica dentro de un artículo |
Enlace de URL externo | Señalando herramientas, documentos o recursos de terceros |
Enlace de correo electrónico ( | Facilitando que los lectores contacten con el soporte o con un equipo |
Añadir hipervínculos a un artículo
Para añadir un hipervínculo en el editor de Markdown, sigue estos pasos:
Selecciona el texto deseado y haz clic en el icono Insertar enlace () en la parte superior del editor. Aparecerá el diálogo Enlace .
Elige una de las siguientes opciones de enlace:
Enlace a un artículo existente: Empieza a escribir el nombre del artículo en el campo Buscar y enlazar al artículo existente . Aparecerá una lista de artículos coincidentes.
Enlace a un encabezado específico en el artículo actual: Utiliza el desplegable de encabezado del enlace al artículo actual para seleccionar un encabezado H2, H3 o H4. El slug de URL apropiado se generará automáticamente.
Enlace a una URL externa: Pega la URL de destino deseada en el campo de URL.
Opcionalmente, selecciona la Abrir en una nueva pestaña si el enlace lleva fuera de tu base de conocimientos. Esto suele ser una buena práctica para enlaces externos para que los lectores no pierdan su lugar.
Haz clic en Ok para añadir el hipervínculo a tu contenido.
En el editor avanzado WYSIWYG , puedes insertar un enlace de tres maneras:
Menú de inserción rápida : Selecciona el texto deseado en el editor WYSIWYG avanzado y aparecerá el menú de inserción rápida . Luego, haz clic en el icono de Enlace () en el menú de inserción rápida .
Comando de corte: Escribe
/Linkpara usar el comando.Ctrl + K: Selecciona el texto deseado y pulsa
Ctrl + K.
Aparecerá el cuadro Añadir enlace .
Hay dos opciones en el cuadro Añadir enlace :
Artículo: Seleccione el botón de opción Artículo para añadir un enlace a un artículo existente o a un encabezado de cualquier artículo de su base de conocimientos.
Enlace externo: Selecciona el botón de opción Enlace externo para añadir un hipervínculo a una URL específica.
Enlace a un artículo
Para añadir un enlace a un artículo en tu base de conocimientos,
Selecciona el botón de opción Artículo en el cuadro de diálogo Añadir enlace .
En el campo Texto , actualiza el texto del hipervínculo si es necesario.
Selecciona el espacio de trabajo y el idioma de tu artículo objetivo en el desplegable Espacio de Trabajo y Lenguaje . Esto es importante en bases de conocimiento multilingües o multiversión.
Para añadir un enlace a un artículo específico, comienza a escribir el nombre del artículo en el campo Buscar artículo . Selecciona el artículo deseado de la lista de artículos coincidentes.
NOTA
Una vez que seleccionas un artículo, aparece la opción de Restablecer al artículo actual . Esto es útil cuando empezaste desde un flujo de trabajo de enlaces de marcadores y quieres volver a enlazar dentro del artículo que estás editando actualmente.
Opcionalmente, selecciona un encabezado específico desde el enlace a un desplegable de encabezado .
Selecciona la Abrir en una nueva pestaña si deseas abrir el enlace en una pestaña nueva.
Haz clic en Añadir.
Enlace a una URL externa
Para añadir un enlace a una URL,
Selecciona el botón de opción Enlace externo en el cuadro de Añadir enlace .
Introduce el texto de visualización en el campo Texto .
Pega la URL de destino en el campo URL .
Selecciona la Abrir en una nueva pestaña si deseas abrir el enlace en una pestaña nueva.
Haz clic en Añadir.
Enlazamiento a encabezados específicos
Cuando se trata de artículos largos o páginas de categoría, los enlaces ancla (también llamados bookmark links o enlaces de fragmentos) permiten dirigir a los lectores a una sección específica dentro de un artículo, no solo a la parte superior de la página.
Por qué esto importa
Los artículos largos son comunes en la documentación técnica. Un lector que llega al principio de un artículo de 3.000 palabras buscando la sección Desinstalar tiene que desplazarse más allá de todo lo demás para encontrarlo. Un enlace ancla les lleva directamente allí.
Esto es especialmente valioso cuando:
Enlaces desde preguntas frecuentes - "¿Cómo restablezco mi contraseña?" enlaza directamente a la sección de Restablecer contraseña de un artículo más extenso sobre gestión de cuentas
Enlaces a partir de mensajes de error - Tu aplicación muestra un error con un enlace de "Más información" que va directamente al paso de resolución de problemas correspondiente
Creación de una tabla de contenidos - Un artículo largo comienza con una lista de secciones, cada una enlazada a su encabezado a continuación
Compartir en tickets de soporte - Los agentes de soporte pegan un enlace que lleva a los clientes directamente al paso relevante, no al inicio de una página
Añadir un enlace de marcador
En el editor avanzado WYSIWYG, sigue estos pasos para guardar enlaces en favoritos dentro de artículos o categorías de página:
Selecciona el texto deseado y pulsa
Ctrl + K. Aparecerá el cuadro de diálogo Añadir enlace .Selecciona el botón de opción Artículo . El campo Texto se rellenará automáticamente con el texto seleccionado. El desplegable Espacio de Trabajo y Idioma mostrará tu espacio de trabajo actual y tu idioma. El campo Buscar artículo se rellenará por defecto al artículo actual.
Selecciona un encabezado dentro del artículo desde el enlace a un desplegable de encabezado. Esto creará un enlace directamente a ese encabezado.
Selecciona la Abrir en una nueva pestaña si deseas abrir el enlace en una pestaña nueva.
Haz clic en Añadir.
NOTA
Los encabezados H3 y H4 solo estarán disponibles en el desplegable si están activados en la configuración. Para activarlos, navega a Configuración () > Sitio de la base de conocimientos Configuración de unartículo y SEO > Configuración del artículo de artículos > Artículo derecho y asegúrate de que H3 y H4 estén seleccionados.
Copiar enlaces de encabezado desde el sitio de la Base de Conocimiento
En la página publicada de la Knowledge Base, aparece un icono de Copiar enlace () junto a cada encabezado de H2, H3 y H4 cuando pasas el cursor sobre él. Al hacer clic se copia la URL directa de esa sección.
Esta función es útil para:
Equipos de soporte - Graba y pega rápidamente un enlace de sección directa en una respuesta de soporte
Documentación interna : enlaza tu wiki interna o mensajes de Slack directamente a una sección específica
Revisores de contenido - Comparte comentarios que apunten a la parte exacta del artículo en discusión
Cómo gestiona Document360 los identificadores de cabeceras
Cada encabezado (H2 a H6) en el editor avanzado WYSIWYG recibe automáticamente un ID único y persistente. El ID se genera en función del contenido predeterminado del idioma tan pronto como pulsas Enter tras escribir un encabezado, y permanece sin cambios, incluso si luego cambias el nombre del encabezado.
Puedes editar libremente el texto de los encabezados sin romper los enlaces existentes, ya sea que apunten a encabezados dentro del mismo artículo o en otro.
Si dos encabezados tienen títulos idénticos, Document360 añade sufijos (
_1,_2, etc.) para mantener los IDs únicos.Los IDs son consistentes entre traducciones. El mismo ID se conserva en todas las versiones lingüísticas de un artículo, por lo que los enlaces siguen funcionando independientemente del idioma que se vea.
Añadir un enlace de correo electrónico
Un enlace de correo electrónico abre el cliente de correo predeterminado del lector con la dirección pre-rellenada. Esto reduce la fricción de copiar y pegar una dirección.
Los usos comunes en la documentación incluyen:
"¿Preguntas sobre este artículo? Envía un correo a nuestros redactores técnicos"
"Para consultas de facturación, contacta con nuestro equipo financiero"
"Reporta una inexactitud en este artículo, avísanos"
Para añadir un enlace de correo electrónico a un artículo en el editor de Markdown, sigue los pasos siguientes:
Selecciona el texto que quieres enlazar y haz clic en el icono Enlace ().
En el campo Enlace a una URL , utiliza el siguiente formato Markdown para crear un enlace de correo electrónico:
[Email](mailto:support@yourcompany.com)
Por ejemplo, si quieres añadir un hipervínculo de correo electrónico con
test@gmail.comel texto "Soporte de correo electrónico", escribe:
[Email support](mailto:test@gmail.com).
Para añadir un enlace de correo electrónico a un artículo en el editor avanzado WYSIWYG, siga los pasos siguientes:
Selecciona el texto deseado y pulsa
Ctrl + K(o usa/link). Aparecerá el cuadro de Añadir Enlace .Selecciona el botón de opción Enlace externo .
En el campo URL , introduce el correo electrónico en el siguiente formato:
mailto:email@example.comHaz clic en Añadir.
Enlazando a archivos (PDFs, imágenes, documentos de Word)
A veces quieres que los lectores hagan clic en un enlace y abran un archivo directamente, un PDF descargable, una hoja técnica, una plantilla de configuración.
Document360 hace esto posible a través del disco:
Sube el archivo a Document360 Drive.
Haz clic en el archivo subido para abrir el panel de detalles del archivo .
En Ubicación, haz clic en el icono de Copiar junto a la ruta del archivo. La URL se verá algo así:
https://cdn.document360.io/abc123/filename.pdf
Ve a tu artículo y selecciona el texto que quieres enlazar.
Pulsa
Ctrl + Kpara abrir el cuadro de Añadir enlace .Selecciona el botón de opción Enlace externo, pega la URL copiada y haz clic en Añadir.
Los lectores ahora pueden hacer clic en el enlace para abrir o descargar el archivo directamente desde la página de la Base de Conocimiento.
Editar o desvincular un hipervínculo
En el editor avanzado WYSIWYG, al hacer clic en cualquier texto hipervinculado se muestra una pequeña barra de herramientas con cuatro opciones; sigue estos pasos para gestionar un hipervínculo:
Haz clic en el texto enlazado. Aparecerá el diálogo Enlace .
Para gestionar el enlace:
Abre el enlace: Haz clic en el enlace para visitar la URL.
Edita el enlace: Haz clic en el icono Editar () para modificar el hipervínculo.
Desvincular el texto: Haz clic en el icono Desvincular () para eliminar el hipervínculo.
Copia el enlace: Haz clic en el icono Copiar () para copiar el hipervínculo.
NOTA
En el editor Markdown, los enlaces se editan manualmente modificando directamente la sintaxis de Markdown.
Cómo gestiona Document360 las URLs de enlaces internos
Cuando creas un enlace interno de artículo, la URL generada puede verse ligeramente diferente dependiendo de tu configuración. Por ejemplo:
https://docs.yourcompany.com/v1/docs/article-name(dominio personalizado con versión de espacio de trabajo)https://yourproject.document360.io/docs/article-name(dominio Document360 por defecto)
Estas variaciones se esperan y gestionan automáticamente. El segmento /v1/ representa la versión del espacio de trabajo. El formato del dominio depende de si usas un dominio personalizado.
Un error 404 solo ocurre cuando:
El artículo objetivo ha sido eliminado, no publicado o ocultado
El rumbo objetivo ya no existe
El enlace se introdujo manualmente con una URL incorrecta
Preguntas frecuentes
¿Puedo enlazar artículos ocultos o no publicados?
Sí, técnicamente puedes añadir el enlace. Sin embargo, los artículos ocultos devolven un error 404 cuando los lectores intentan visitarlos en la base de conocimientos. Enlazar a un borrador o artículo oculto no lo hace visible públicamente, solo será accesible cuando su Workflow status esté configurado como Publicado.
Esto puede ser intencionado en algunos flujos de trabajo: puedes redactar un artículo, añadir enlaces internos de otros artículos y publicar todo solo a la vez. Solo ten en cuenta que hasta que se publique, cualquier lector que haga clic en ese enlace recibirá un error 404.
¿Se romperán mis enlaces de encabezado si cambio el nombre o edito un encabezado?
No. Document360 utiliza un ID único y persistente para cada encabezado, no el texto del encabezado, para generar enlaces de anclaje. Este ID se asigna cuando se crea el encabezado y nunca cambia, independientemente de cuántas veces edites el texto del encabezado después.
Si dos encabezados comparten el mismo título, Document360 añade automáticamente sufijos ( _1, _2, etc.) para mantener cada ID único.
¿Puedo enlazar imágenes o PDFs alojados en Document360 Drive?
Sí. Sube el archivo a Document360 Drive, copia la URL de su ruta del archivo desde el panel de detalles del archivo y úsalo como enlace externo en cualquier artículo. Los lectores que hagan clic en el enlace irán directamente al archivo.
¿Cuál es la diferencia entre un enlace de marcador y un enlace ancla de encabezado?
Son lo mismo en Document360. Ambos se refieren a un enlace que apunta a un encabezado específico (H2, H3 o H4) dentro de un artículo, en lugar de a la parte superior de la página. Los términos se usan indistintamente.
¿Puedo enlazar un artículo replicado?
No. Los artículos creados usando la función Replicar no pueden añadirse como enlaces internos en otros artículos. Aún puedes enlazar al artículo original. Si necesitas una copia enlazable, considera crear un nuevo artículo desde cero en lugar de usar la función de replicar.
¿Deberían abrirse los enlaces internos en una nueva pestaña?
No hay una única respuesta correcta, pero una convención común es:
Enlaces internos de artículos — Ábrense en la misma pestaña (mantiene al lector dentro del flujo de tu base de conocimiento)
Enlaces externos — Abrir en una pestaña nueva (mantiene tu base de conocimientos abierta en segundo plano)
Descargas de archivos — Abrir en una pestaña nueva (evita alejarse del artículo)
Document360 te da la opción en cada enlace: usa tu criterio según hacia dónde lleva el enlace y la experiencia que quieres para el lector.