Skip to content

myDeity/searchlink

 
 

Repository files navigation

Introduction

SearchLink is a System Service (Quick Action) for macOS which searches multiple web sources and automatically generates Markdown links for text. It allows you to write without leaving your editor to run web searches for the items you want to link to. It's great for blogging, and excellent for creating podcast show notes, among other things.

It works in a few ways:

  • Run a quick search on a single selection, and have the selection replaced with the resulting url (and optional title) as a Markdown inline link, a Markdown reference, or just a plain url.
  • Run a single search and have the results put on your clipboard, perfect for using from scripts and launchers (e.g. LaunchBar or Alfred).
  • The "bracket" format, which allows you to just write, marking things to link as you go. When you're done, you can run it on the full document and --- if your queries were good --- have your links generated automatically without ever opening a browser.

This has replaced the "Auto-link web search" service in the Markdown Service Tools. The difference is that you can now mark links and specify how they should be searched, as well as provide alternate query terms for linked text.

Here's a video tutorial from Aaron Dowd (@thepodcastdude):

Intro to SearchLink on YouTube

Also see:

Accurate searches for better results:

Accurate searches for better results]

Browser history, bookmarks, and Pinboard search:

Browser history, bookmarks, and Pinboard search

Documentation

The documentation has moved to the wiki.

Download

There will likely be updates to this as I solve more problems, so keep an eye on this page for new versions. The current source code is available on GitHub.

SearchLink can also be installed via Homebrew, thanks to @TomBen:

brew tap tombener/tap && brew install --cask searchlink

Download SearchLink 2.3.65.

If you're interested in installing SearchLink as a command line tool, see the wiki.

Plugins

All of SearchLink's searches are defined using a plugin architecture. You can see more examples and fodder for building your own in the SearchLink Plugins repository.

Bonus for LaunchBar users

With the AppleScript below saved to ~/Library/Application Support/LaunchBar/Actions/Instant Search.scpt, you can use SearchLink as a launcher for the web. Load the action in LaunchBar, type Space and enter a SearchLink simple query (just text with optional !arg at the beginning). When you hit Enter it will grab the first link and load it in the Open URL action. Enter again will open it in your browser, ???C will copy it to your clipboard.

Note that you don't need the normal "!!" at the end of the search string to specify that SearchLink should just return the URL, that's included in the script.

View the Script

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 99.8%
  • Dockerfile 0.2%