Gestion des liens

Liens internes (slugs) et externes (URLs absolues)

Liens internes

Les liens internes permettent de naviguer entre les pages de votre site Markdodo. Ils utilisent le slug de la page cible, et non un chemin complet avec des /. Cela rend les liens courts, lisibles et résilients.

Syntaxe

Pour créer un lien vers une autre page du site, utilisez la syntaxe Markdown avec le slug directement :

[Voir la documentation](documentation)
[Page d'authentification](authentification)
[Retour à l'accueil]()

Page d'accueil

La page d'accueil possède un slug vide. Pour la cibler, laissez les parenthèses vides :

[Accueil]()

Pages enfant

Chaque slug est unique sur le site, il n'y a pas de chemin hiérarchique. Le slug suffit toujours à identifier la page :

[Endpoints](endpoints)
[Gestion du menu](menu)
[Images](images)

Important : n'ajoutez pas de / ni de chemin hiérarchique dans les liens internes. Utilisez uniquement le slug de la page cible.

Liens externes

Les liens externes pointent vers des ressources situées en dehors de votre site Markdodo. Ils utilisent des URLs absolues :

[Site officiel](https://markdodo.com)
[Documentation MDN](https://developer.mozilla.org)
[GitHub](https://github.com)

Bonnes pratiques

• Privilégiez les liens internes pour naviguer au sein de votre site. Ils sont plus courts, plus lisibles et ne cassent pas si le domaine change.
• Utilisez des libellés descriptifs : évitez les textes comme "cliquez ici" et préférez des libellés qui indiquent la destination du lien.
• Vérifiez vos slugs : avant de créer un lien interne, assurez-vous que le slug de la page cible est correct en consultant la réponse du GET /api/pages.
• Slugs immuables : les slugs de pages sont définitifs après création. Vos liens internes ne casseront jamais tant que la page existe.