Hyperlinks zijn een van de krachtigste hulpmiddelen in technische documentatie. Goed uitgevoerd, verminderen ze wrijving voor lezers, houden je content verbonden en verbeteren ze hoe je Knowledge base presteert in zoekopdrachten. Slecht uitgevoerd zorgen ze voor doodlopende wegen, gebroken ervaringen en gefrustreerde gebruikers.
In Document360 kun je hyperlinks toevoegen naar tekst, afbeeldingen en bestanden binnen je artikelen of categoriepagina's, met links naar gerelateerde inhoud, externe bronnen of specifieke secties binnen hetzelfde artikel. Als je bijvoorbeeld een software-installatiehandleiding schrijft, bespaart een hyperlink naar de downloadpagina je lezers het zelf hoeven te zoeken.
Dit artikel behandelt alles wat je moet weten over het toevoegen, beheren en optimaliseren van hyperlinks in Document360, zowel in de Markdown - als Advanced WYSIWYG editor.
Waarom hyperlinks belangrijk zijn in een kennisbank
Voordat we ingaan op het hoe, is het de moeite waard om het waarom te begrijpen.
Voor lezers betekenen hyperlinks dat ze nooit halverwege een taak hoeven te vertrekken om op zoek te gaan naar gerelateerde informatie. Als een gebruiker je "Getting Started"-gids leest en API-authenticatie moet begrijpen, brengt een hyperlink hem direct daarheen, zonder zoeken, zonder contextwisseling.
Voor je kennisbasis geeft een goed gekoppelde structuur aan zoekmachines (en AI-systemen) het signaal dat je content gezaghebbend, georganiseerd en uitgebreid is. Dit beïnvloedt direct SEO (hoe goed je artikelen scoren in Google), AEO (Answer Engine Optimization, hoe vaak AI-assistenten je content citeren) en GEO (Generatieve Engine Optimization, of tools als ChatGPT, Perplexity of Claude je content als bron gebruiken).
Voor je supportteam verminderen hyperlinks tussen gerelateerde artikelen herhalende vragen. In plaats van dezelfde uitleg over vijf artikelen te herschrijven, schrijf je het één keer en link je er overal naar.
Voor contentbeheerders betekenen ankerlinks en persistente kop-ID's dat je artikelen kunt herstructureren zonder elke link die ernaar verwijst te breken.
Soorten hyperlinks die je kunt maken in Document360
Document360 ondersteunt vier hoofdtypen hyperlinks, elk met een ander doel:
Linktype | Het beste gebruik voor |
|---|---|
Link naar het interne artikel | Gerelateerde onderwerpen verbinden binnen je kennisbasis |
Koers/ankerlink | Diepe linken naar een specifieke sectie binnen een artikel |
Externe URL link | Wijzen naar tools van derden, documentatie of bronnen |
E-mail ( | Het maakt het gemakkelijk voor lezers om contact op te nemen met support of een team |
Hyperlinks toevoegen aan een artikel
Om een hyperlink toe te voegen aan de Markdown-editor, volg je deze stappen:
Selecteer de gewenste tekst en klik op het pictogram 'Link invoegen ' () bovenaan de editor. Het Link verschijnt.
Kies een van de volgende linkopties:
Link naar een bestaand artikel: Begin met het typen van de artikelnaam in het veld Zoeken & link naar bestaand artikel . Er verschijnt een lijst met overeenkomende artikelen.
Link naar een specifieke kop in het huidige artikel: Gebruik de Link naar de huidige artikelkop om een H2-, H3- of H4-kop te selecteren. De juiste URL-slug wordt automatisch gegenereerd.
Link naar een externe URL: Plak de gewenste bestemmings-URL in het URL-veld.
Selecteer optioneel het vakje Open in a new tab ' als de link buiten je kennisbank valt. Dit is over het algemeen een goede gewoonte voor externe links zodat lezers hun plek niet verliezen.
Klik op Oké om de hyperlink aan je content toe te voegen.
In de Advanced WYSIWYG-editor kun je een link op drie manieren invoegen:
Snel invoegmenu: Selecteer de gewenste tekst in de Geavanceerde WYSIWYG-editor en het menu Snel invoegen verschijnt. Klik vervolgens op het Link () icoon in het menu voor snelle invoeg.
Slash-commando: Typ
/Linkom het commando te gebruiken.Ctrl + K: Selecteer de gewenste tekst en druk
Ctrl + Kop .
De Add link ' verschijnt.
Er zijn twee opties in het Add link :
Artikel: Selecteer de knop ' Artikel ' om een link toe te voegen naar een bestaand artikel, of naar een kop uit een artikel in je kennisbank.
Externe link: Selecteer de knop Externe link om een hyperlink naar een specifieke URL toe te voegen.
Link naar een artikel
Om een link naar een artikel toe te voegen aan je kennisbank,
Selecteer de Article-radioknop in het venster Link toevoegen .
Werk indien nodig de hyperlinktekst bij in het tekstveld .
Selecteer de werkruimte en taal van je doelartikel uit het keuzemenu Workspace & Language . Dit is van belang in meertalige of meervoudige versie-kennisbanken.
Om een link naar een specifiek artikel toe te voegen, begin je met het typen van de artikelnaam in het veld Zoek artikel . Selecteer het gewenste artikel uit de lijst met overeenkomende artikelen.
OPMERKING
Zodra je een artikel selecteert, verschijnt er een optie 'Reset naar huidig artikel '. Dit is handig wanneer je bent begonnen met een workflow voor bladwijzerlinken en terug wilt naar het linken binnen het artikel dat je op dat moment bewerkt.
Selecteer optioneel een specifieke kop van de Link naar een kop-dropdown .
Selecteer het vakje Open in a new tab ' als je de hyperlink in een nieuw tabblad wilt openen.
Klik op Toevoegen.
Link naar een externe URL
Om een link naar een URL toe te voegen,
Selecteer de radioknop Externe link in het venster Link toevoegen .
Voer de weergavetekst in het tekstveld.
Plak de bestemmings-URL in het URL-veld .
Selecteer het vakje Open in a new tab ' als je de hyperlink in een nieuw tabblad wilt openen.
Klik op Toevoegen.
Linken naar specifieke koppen
Bij het werken met lange artikelen of categoriepagina's kun je ankerlinks (ook wel bookmark links of fragmentlinks genoemd) lezers naar een specifieke sectie binnen een artikel verwijzen, niet alleen naar de bovenkant van de pagina.
Waarom dit belangrijk is
Lange artikelen komen vaak voor in technische documentatie. Een lezer die bovenaan een artikel van 3.000 woorden komt op zoek naar de sectie Verwijderen moet overal voorbij scrollen om het te vinden. Een ankerlink brengt hen direct daarheen.
Dit is vooral waardevol wanneer:
Linken uit FAQ's - "Hoe reset ik mijn wachtwoord?" linkt direct naar het gedeelte Wachtwoord resetten van een langer accountbeheerartikel
Linking vanuit foutmeldingen - Je app toont een foutmelding met een "Meer informatie"-link die direct naar de relevante probleemoplossingsstap gaat
Een inhoudsopgave maken - Een lang artikel begint met een lijst van secties, elk gekoppeld aan de kop hieronder
Delen in supporttickets - Supportmedewerkers plakken een link die klanten direct naar de relevante stap leidt, niet naar het begin van een pagina
Een bladwijzerlink toevoegen
Volg in de Advanced WYSIWYG-editor deze stappen om links binnen artikelen of paginacategorieën te bookmarken:
Selecteer de gewenste tekst en druk
Ctrl + Kop . Het dialoog 'Link toevoegen ' verschijnt.Selecteer de radioknop Artikel . Het tekstveld vult automatisch je geselecteerde tekst in. Het keuzemenu Werkruimte & Taal toont je huidige werkruimte en taal. Het veld Zoek artikel wordt standaard naar het huidige artikel gegooid.
Selecteer een kop binnen het artikel via de Link naar een kop-dropdown. Dit maakt een link direct naar die kop.
Selecteer het vakje Open in a new tab ' als je de hyperlink in een nieuw tabblad wilt openen.
Klik op Toevoegen.
OPMERKING
De H3 - en H4-koppen zijn alleen beschikbaar in het dropdownmenu als ze in de instellingen zijn ingeschakeld. Om ze in te schakelen, ga je naar () > Knowledge base site > Article settings & SEO > Article settings > Artikel rechts en zorg dat H3 en H4 geselecteerd zijn.
Koplinks kopiëren van de Knowledge Base-site
Op de gepubliceerde kennisbanksite verschijnt er een pictogram 'Link kopiëren ' () naast elke kop van H2, H3 en H4 wanneer je eroverheen gaat. Door erop te klikken kopieer je de directe URL naar dat gedeelte.
Deze functie is nuttig voor:
Supportteams - Pak snel een directe sectielink en plak ze in een supportantwoord
Interne documentatie - Koppel je interne wiki of Slack-berichten direct aan een specifieke sectie
Contentbeoordelaars - Deel feedback die wijst op het exacte deel van een artikel dat wordt besproken
Hoe Document360 omgaat met kop-ID's
Elke kop (H2 tot H6) in de Advanced WYSIWYG-editor krijgt automatisch een unieke, persistente ID toegewezen. De ID wordt gegenereerd op basis van de standaardtaalinhoud zodra je na het typen van een kop druktEnter, en blijft ongewijzigd, zelfs als je de kop later hernoemt.
Je kunt vrij koptekst bewerken zonder bestaande links te breken, of ze nu verwijzen naar koppen binnen hetzelfde artikel of in een ander artikel.
Als twee koppen identieke titels hebben, voegt Document360 achtervoegsels toe (
_1,_2, enz.) om ID's uniek te houden.ID's zijn consistent over vertalingen heen. Dezelfde ID wordt in elke taalversie van een artikel behouden, dus links blijven functioneel ongeacht de taal waarin ze worden bekeken.
Een e-maillink toevoegen
Een e-maillink opent de standaard e-mailclient van de lezer met het adres vooraf ingevuld. Dit vermindert de wrijving van het kopiëren en plakken van een adres.
Veelvoorkomende toepassingen in documentatie zijn onder andere:
"Vragen over dit artikel? Mail onze technische schrijvers"
"Voor facturatievragen, neem contact op met ons financiële team"
"Meld een onjuistheid in dit artikel, laat het ons weten"
Om een e-maillink aan een artikel toe te voegen in de Markdown-editor, volgt u de onderstaande stappen:
Selecteer de tekst die je wilt linken en klik op het Link () icoon.
Gebruik in het veld Link naar een URL het volgende Markdown-formaat om een e-maillink te maken:
[Email](mailto:support@yourcompany.com)
Als je bijvoorbeeld een e-mailhyperlink
test@gmail.comwilt toevoegen met de linktekst "E-mailondersteuning", typ:
[Email support](mailto:test@gmail.com).Resultaat: E-mailondersteuning
Om een e-maillink toe te voegen aan een artikel in de Advanced WYSIWYG-editor, volg je de onderstaande stappen:
Selecteer de gewenste tekst en druk
Ctrl + K(of gebruik/link)). Het dialoogvenster Link toevoegen verschijnt.Selecteer de radioknop Externe link .
Voer in het URL-veld het e-mailadres in in het volgende formaat:
mailto:email@example.comKlik op Toevoegen.
Linken naar bestanden (PDF's, afbeeldingen, Word-documenten)
Soms wil je dat lezers op een link klikken en direct een bestand openen, een downloadbare PDF, een specificatieblad, een configuratiesjabloon.
Document360 maakt dit mogelijk via de Drive:
Upload het bestand naar Document360 Drive.
Klik op het geüploade bestand om het paneel met bestandsdetails te openen.
Klik onder Locatie op het Kopiëren-icoon naast het bestandspad. De URL ziet er ongeveer zo uit:
https://cdn.document360.io/abc123/filename.pdf
Ga naar je artikel en selecteer de tekst die je wilt linken.
Druk
Ctrl + Kom het venster Link toevoegen te openen.Selecteer de radioknop Externe link , plak de gekopieerde URL en klik op Toevoegen.
Lezers kunnen nu op de link klikken om het bestand direct van de Knowledge Base-site te openen of downloaden.
Een hyperlink bewerken of ontkoppelen
In de Advanced WYSIWYG-editor verschijnt bij het klikken op een gehyperlinkte tekst een kleine werkbalk met vier opties; volg deze stappen om een hyperlink te beheren:
Klik op de gehyperlinkte tekst. De Link verschijnt.
Om de hyperlink te beheren:
Open de link: Klik op de link om de URL te bezoeken.
Bewerk de link: Klik op het Edit () om de hyperlink te wijzigen.
Ontkoppel de tekst: Klik op het ontkoppelen () icoon om de hyperlink te verwijderen.
Kopieer de link: Klik op het Copy ()-icoon om de hyperlink te kopiëren.
OPMERKING
In de Markdown-editor worden links handmatig bewerkt door direct de Markdown-syntaxis aan te passen.
Hoe Document360 interne link-URL's afhandelt
Wanneer je een interne artikellink maakt, kan de gegenereerde URL er iets anders uitzien afhankelijk van je setup. Bijvoorbeeld:
https://docs.yourcompany.com/v1/docs/article-name(aangepaste domein met werkruimteversie)https://yourproject.document360.io/docs/article-name(standaard Document360-domein)
Deze variaties worden verwacht en automatisch afgehandeld. Het /v1/ segment vertegenwoordigt de werkruimteversie. Het domeinformaat hangt af van of je een aangepast domein gebruikt.
Een 404-fout doet zich alleen voor wanneer:
Het doelartikel is verwijderd, ongepubliceerd of verborgen
De doelkop bestaat niet meer
De link werd handmatig ingevoerd met een verkeerde URL
FAQ
Kan ik verborgen artikelen of ongepubliceerde artikelen hyperlinken?
Ja, technisch gezien kun je de link toevoegen. Verborgen artikelen geven echter een 404-fout wanneer lezers proberen ze te bezoeken op de Knowledge Base-site. Het linken naar een concept of verborgen artikel maakt het niet openbaar zichtbaar, het wordt pas toegankelijk zodra de Workflow status op Gepubliceerd staat.
Dit kan in sommige workflows opzettelijk zijn: je kunt een artikel opstellen, interne links toevoegen van andere artikelen, en alles in één keer publiceren. Wees je er wel van bewust dat elke lezer die op die link klikt een 404-fout krijgt totdat het gepubliceerd is.
Gaan mijn koplinks kapot als ik een kop hernoem of bewerk?
Nee. Document360 gebruikt een unieke, persistente ID voor elke kop, niet voor de koptekst, om ankerlinks te genereren. Deze ID wordt toegewezen wanneer de kop voor het eerst wordt aangemaakt en verandert nooit, ongeacht hoe vaak je de koptekst daarna bewerkt.
Als twee koppen dezelfde titel delen, voegt Document360 automatisch achtervoegsels toe ( _1, _2, enz.) om elke ID uniek te houden.
Kan ik links links naar afbeeldingen of PDF's die in Document360 Drive worden gehost?
Ja. Upload het bestand naar Document360 Drive, kopieer de URL van het bestandspad uit het paneel Bestandsdetails en gebruik het als externe link in elk artikel. Lezers die op de link klikken, worden direct naar het bestand geleid.
Wat is het verschil tussen een bladwijzerlink en een anchorlink voor de kop?
Ze zijn hetzelfde in Document360. Beide verwijzen naar een link die naar een specifieke kop (H2, H3 of H4) binnen een artikel verwijst, in plaats van naar de bovenkant van de pagina. De termen worden door elkaar gebruikt.
Mag ik een link naar een gerepliceerd artikel linken?
Nee. Artikelen die zijn gemaakt met de Replicate-functie kunnen niet als interne links worden toegevoegd in andere artikelen. Je kunt nog steeds naar het originele artikel linken. Als je een linkbare kopie nodig hebt, overweeg dan om een nieuw artikel vanaf nul aan te maken in plaats van de replicate-functie te gebruiken.
Moeten interne links openen in een nieuw tabblad?
Er is geen eenduidig juist antwoord, maar een veelvoorkomende conventie is:
Interne artikellinks — Open in hetzelfde tabblad (houdt de lezer binnen je kennisbankstroom)
Externe links — Open in een nieuw tabblad (houdt je kennisbank op de achtergrond open)
Bestanden downloaden — Openen in een nieuw tabblad (voorkomt dat je het artikel verlaat)
Document360 geeft je de optie bij elke link — gebruik je oordeel op basis van waar de link naartoe leidt en welke ervaring je voor de lezer wilt.