Hosted onseed.hyper.mediavia theHypermedia Protocol

Document cover
Create and edit a document link

As an editor I want to create and manage links in my text so that I can connect content to documents or external URLs.

Acceptance criteria

  • In read mode, clicking a link navigates to the destination.

  • In edit mode, users just delete the link if they want to change it and create another one.

  • In edit mode, clicking a link opens a tooltip to open and edit the link.

  • To enter edit mode when a block is all links and has no plain text to click, the user can click the block's margin or Edit inside the tooltip.

  • Users without edit permissions are always in read mode — clicking a link always navigates.

  • To create a link: select text → click the link icon in the toolbar → type a URL or search for a doc.

  • A URL creates a static link (label never changes). Selecting an internal doc creates a dynamic link (label syncs with doc title).

  • Editing a link reopens the popover pre-filled. The user can change destination, switch type, or remove the link.

Inspiration from Notion and link behaviour

By order / I proposed to use the same logic:

  • External link: when clicking will open the url in a blank page

  • External subdocument: when clicking will open the original document source changing the breadcrumb.

  • Internal subdocument: when clicking will open the document in the parent where user is.

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime