Paste URL into selection

The plugin provides two primary workflows for handling URLs and text:

1. Link text with a URL: Select a piece of text and use the standard Ctrl/Cmd + V (Paste) command. The plugin will wrap the selected text in a link using the URL currently in your clipboard, similar to how Notion handles pasting links.

2. Insert text into a URL: Select an existing link (URL) and trigger the plugin's command via the Obsidian Command Palette or a manually assigned hotkey. This will replace the URL with the text currently in your clipboard.

The nothingSelected setting determines how the plugin behaves when you paste a URL and no text is currently selected in Obsidian. You can choose from the following modes via the NothingSelected enum:

• doNothing: Uses the default Obsidian paste behavior.
• autoSelect: Automatically selects the word surrounding the cursor before pasting.
• insertInline: Formats the paste as a Markdown inline link: [](url).
• insertBare: Inserts the URL as plain text: <url>.

// Possible values for the nothingSelected setting:
// NothingSelected.doNothing
// NothingSelected.autoSelect
// NothingSelected.insertInline
// NothingSelected.insertBare

The isUrl function determines if a given string should be treated as a URL or a link. It returns true if the text matches any of the following criteria:

1. It is an Obsidian wikilink format (e.g., [[Link]]).
2. It is a valid URL with a recognized scheme (e.g., http, https, obsidian, mailto, etc.).
3. It is a valid file path (Windows or Unix style).
4. It matches the fallback regular expression provided in the plugin settings (settings.regex).

Note: To avoid false positives, the plugin only accepts a specific set of VALID_URL_SCHEMES.

// Example usage (conceptual):
// isUrl(text, settings) returns true for:
// - '[[My Note]]'
// - 'https://example.com'
// - 'C:\Users\Name\file.txt'
// - 'file:///path/to/file'

The plugin registers a command that allows users to manually trigger the URL-into-selection logic. When this command is invoked, it reads the current text from the system clipboard and applies it to the current editor selection using the plugin's settings.

Command Details:

• ID: paste-url-into-selection
• Behavior: Reads clipboard text via navigator.clipboard.readText() and passes it to the UrlIntoSelection core function.

The PluginSettings object defines the configuration structure for the plugin. Use these keys when programmatically interacting with or extending the settings.

export interface PluginSettings {
  regex: string; // Fallback regular expression for URL matching
  nothingSelected: NothingSelected; // Behavior when no text is selected (0, 1, 2, or 3)
  listForImgEmbed: string; // Regex-based whitelist for image embeds, split by line breaks
}

The PluginSettings interface defines the configuration schema for the plugin. Use these keys to customize URL detection and pasting behavior:

• regex: A string representing the regular expression used to identify URLs.
• nothingSelected: A value from the NothingSelected enum determining behavior when no text is selected.
• listForImgEmbed: A string used to define the list for image embedding.

export interface PluginSettings {
  regex: string;
  nothingSelected: NothingSelected;
  listForImgEmbed: string;
}