This plugin inserts hyperlink into reading view of Obsidian documents according to user-defined rule.

EXPERIMENTAL: The plugin has new option to insert hyperlink to editor view. To enable this feature, please enable the option in the setting menu. Note that it directly edits your documents. Since this feature is still experimental, edits could result in unexpected result.

In the plugin setting pane, you can define hyperlink rule in the form of JSON. Its key should be a pattern that matches the words that you want to insert hyperlink. Corresponding value is a template for URL to be inserted. For example, the following rule will detect every words of "Obsidian" and insert a link to https://github.com/obsidianmd, which is almost equivalent to write [Obsidian](https://github.com/obsidianmd) in editing mode. If your document contains many "Obsidian"'s, this plugin automatically inserts a link to all of them - no manual linking, no omission.

{
    "Obsidian": "github.com/obsidianmd"
}

If you omit https://, the plugin automatically prepend it. If you need to access the site with http (non-secure HTTP), the template have to start with http://.

You can use regex (regular expression) for matching. Pattern string is given to RegExp to enable regex mathing. The following rule will detect all of "Obsidian" (capitalized) and "obsidian" (lower letter), insert a link to https://obsidian.md.

{
    "[oO]bsidian": "obsidian.md"
}

JSON value can be a template rather than direct URL. You can embed matched string using placeholder. The above rule is equivalent to the following.

{
    "[oO]bsidian": "$0.md"
}

In the template, $0 is a placeholder that is replaced by matched pattern. Resulting URL will be obsidian.md or Obsidian.md depending on the matched string is either capitalized or in lower letter case (it seems that the latter URL is redirected to the former). You can use placeholders for subpattern as $ with positive integer like $1. The following example uses subpattern to insert a link to GitHub pull requests.

{
    "Obsidian PR #([0-9]+)": "github.com/obsidianmd/obsidian-releases/pull/$1"
}

When the pattern matches "Obsidian PR #10", $0 corresponds to whole matched string while $1 is replaced with the first subpattern enclosed by parenthesis, which is 10 in this case. So, resulting URL will be https://github.com/obsidianmd/obsidian-releases/pull/10

You can define multiple rules by separating them with comma. Be careful about the ordering of rules. If multiple rules exist, upper rule take priority. If you have the following two rules, "obsidian" (lower letter) will be linked to https://obsidian.md but "Obsidian" (capitalized) will be linked to https://github.com/obsidianmd because upper rule takes priority.

{
    "Obsidian": "github.com/obsidianmd",
    "[oO]bsidian": "$0.md"
}

There is a toggle to enable/disable feature on mobile environment. The feature is disabled by default because it is still experimental.

This section demonstrates how plugin works.

Suppose you have the following markdown text.

## Section: Obsidian

Obsidian and obsidian, its public releases are hosted by GitHub. Obsidian PR #10 had been issued to add table-editor-obsidian plugin.

- Auto Hyperlink inserts all occurrence of "Obsidian" or "obsidian" even in the list item

And you have hyperlink rule below.

{
    "Obsidian PR #([0-9]+)": "github.com/obsidianmd/obsidian-releases/pull/$1",
    "Obsidian": "github.com/obsidianmd",
    "[oO]bsidian": "https://$0.md"
}

When you switch to reading view, you will find that many links are inserted by the plugin. The link is also available in the exported PDF file.

You can try it by yourself with the following procedure.

1. install Auto Hyperlink plugin and enable it
2. create new file, copy above markdown text
3. open plugin setting, and copy above rule to the text area
4. go back to newly created file, switch to reading view

@take6