Skip to content

Feature request: Add “Insert Link” action (menu item or context menu) for Markdown links #170

Open

Description

@svatas

Description

I’d like to suggest a small but very impactful UX improvement related to inserting links.


Problem

At the moment, creating links in Mark Sharp requires typing raw Markdown syntax manually:

[link text](https://example.com)

While this is perfectly fine for experienced Markdown users, it becomes a noticeable friction point in these situations:

  • editing text-heavy documents (articles, documentation),
  • frequent link insertion during writing,
  • switching from other WYSIWYG-style editors,
  • users who rely on mouse / context menus rather than syntax.

There is currently:

  • no menu action,
  • no context menu item,
  • no simple UI affordance
    to convert selected text into a link.

Proposed feature

Add a simple “Insert Link” action, inspired by existing patterns in other Markdown WYSIWYG editors.

Two possible UX variants (either would already be a big improvement):

Variant A – Command / main menu action

  • Add an action like:
    Insert → Link
  • Behavior:
    • if text is selected → wrap it as url
    • prompt user for URL
    • keep cursor position

Variant B – Context menu (right click)

  • On selected text:
    Right click → Insert Link
  • Same behavior as above

Both variants are well-established and intuitive in editors like Typora, Google Docs, Medium editor, etc.


Why this matters

  • Reduces cognitive load during writing
  • Improves flow when editing long-form content
  • Removes unnecessary syntax typing for a very common operation
  • Makes Mark Sharp more approachable for non-Markdown-native writers
  • Aligns well with Mark Sharp’s goal of being a modern, writer-friendly Markdown editor

This would not replace Markdown-first workflows – it would simply augment them with a lightweight UI shortcut.


Scope & implementation notes (non-binding)

From a user perspective, this could be implemented as:

  • a command (markSharp.insertLink)
  • registered in the command palette
  • exposed in the context menu for text selections

Even a minimal first implementation (prompt + wrapper) would already be extremely helpful.


Summary

Adding a simple Insert Link UI action would significantly improve everyday writing ergonomics in Mark Sharp without compromising its Markdown-first philosophy.

Activity

  1. jonathanyeung commented on Apr 11, 2026

    @jonathanyeung
    Owner

    Hi @svatas - thanks for the detailed suggestion; I've been planning on expanding the options available in the context menu, including adding an option for link creation.

    There is one easier way to create links that already exists, although with poor discoverability: If you have a link copied on your clipboard (like https://www.google.com), and then you highlight a portion of text, then paste, the text will get converted to a link.

  2. svatas commented on Apr 14, 2026

    @svatas
    Author

    There is one easier way to create links that already exists, although with poor discoverability: If you have a link copied on your clipboard (like https://www.google.com), and then you highlight a portion of text, then paste, the text will get converted to a link.

    So this workaround is perfect for my use case. I usually have the text written first and then want to insert a link to a specific page. In that situation, there is no real need to insert the link via a menu (I mean /) as I can use this CTRL+C and CTRL+V.
    Automatic conversion of URLs starting with https:// also works well when adding new links. However, from a functional UI point of view, link insertion via a menu still makes perfect sense.
    Thanks for the tip!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions