Marks

&dactyl.appName; supports a number of different methods of marking your place, in order to easily return later:

Bookmarks

Bookmarks are the most traditional kind of marks supported by &dactyl.appName;. They are accessible through &dactyl.host;'s bookmark menu, sidebar, and toolbar, in addition to its location bar completion system. &dactyl.appName; makes them accessible not only via several commands and its completion system (see the complete option), but also displays a ❤ in the status bar when a bookmarked page is displayed.

a :bma :bmark :bmark! options url a

Add a bookmark.

The following options are available:

-charset
Character encoding to use for the bookmark. Useful e.g. for sites that require query parameters in encodings other than UTF-8 (short name -c).
-id
The numerical ID of a bookmark to update.
-keyword
A keyword which may be used to open the bookmark via the URL bar or :open prompt. If the url contains the string %s it is replaced by any text following the keyword when it is opened. See also ;S. (short name -k)
-post
Data to be POSTed to the server when the bookmark is opened.
-tags
Comma-separated list of tags for grouping and later access (short name -T).
-title
The title of the bookmark. Defaults to the page title, if available, or url otherwise. (short name -t)

If url is omitted, the URL of the currently loaded web page is used.

If ! is present, a new bookmark is always added. Otherwise, the first bookmark matching id, keyword, or url is updated.

A A

Toggle bookmarked state of current URL. Add/remove a bookmark for the current location, depending on whether it is already bookmarked. New bookmarks are placed in the Unfiled Bookmarks folder, and don't appear in the bookmarks menu or toolbar, but do appear in location bar and :open completions, as well as the :bmarks list.

:bmarks :bmarks! filter

List or open multiple bookmarks. Opens the message window at the bottom of the screen with all bookmarks with URLs matching filter. The resulting URLs can be clicked, or accessed via extended hint modes such as ;o.

The special version :bmarks! works the same as :bmarks except that it opens all matching bookmarks in new tabs rather than listing them.

The bookmarks may also be filtered via the following options:

-keyword
The bookmark's keyword (short name -k).
-tags
A comma-separated list of tags, all of which must be present for a match (short name -T).
-title
The title of the bookmark (short name -t).
-max
The maximum number of items to list or open (short name -m).
:delbm :delbmarks :delbm[arks] url :delbm[arks]!

Deletes all bookmarks which match url. If omitted, url defaults to the URL of the current buffer.

Accepts the same options as :bmarks.

If ! is specified then all bookmarks will be deleted.

QuickMarks

QuickMarks are bookmarks stripped to the bone for quickly getting to the pages that you visit most. A QuickMark is simply a URL assigned to a letter or digit. They can therefore be saved or opened with only three key presses each. QuickMarks are persistent across browser sessions.

M Ma-zA-Z0-9

Add new QuickMark for current URL. You can later jump to the mark with goa-zA-Z0-9 gna-zA-Z0-9.

go goa-zA-Z0-9

Jump to a QuickMark in the current tab. See also M and :qmark.

gn gna-zA-Z0-9

Jump to a QuickMark in a new tab. The new tab is focused only if activate contains quickmark or all. See also M and :qmark.

Mnemonic: Go in a new tab.

 :delqm :delqmarks :delqmarks arg :delqmarks!

Delete the specified QuickMarks.

Examples:

  • :delqmarks Aa b p deletes QuickMarks A, a, b and p
  • :delqmarks b-p deletes all QuickMarks in the range b to p
  • :delqmarks! deletes all QuickMarks
 :qma :qmark :qmark a-zA-Z0-9 url

Mark url with a letter or digit for quick access. See also go, gn, and M.

In addition to simple URLs, url may be any string that can be passed to :open.

:qmarks :qmarks arg

List QuickMarks. If arg is given then limit the list to those QuickMarks mentioned, otherwise list them all.

Local marks and URL marks

Local and URL marks allow you to mark your position on the current page to quickly return later. Each mark is assigned to a letter. Lowercase letters behave as local marks, while uppercase letters act as URL marks. The difference between the two is that local marks apply uniquely to each page, while URL marks mark a specific position on a specific page. So, while the mark m may take you to the top of the page on Site 1, it may take you to the middle on Site 2. The mark M, on the other hand, will always return you to Site 1, possibly switching buffers or creating a new one. All marks are persistent across browser sessions.

m ma-zA-Z

Set mark at the cursor position. Marks a-z are local to the buffer, whereas A-Z are valid between buffers.

` ' 'a-zA-Z' `a-zA-Z'

Jump to the mark. Marks a-z are local to the buffer, whereas A-Z are valid between buffers. The special mark ' holds the buffer position before the last scrolling action.

:delm :delmarks :delmarks arg :delmarks!

Delete the specified marks.

Examples:

  • :delmarks Aa b p deletes marks A, a, b, and p
  • :delmarks b-p deletes all marks in the range b to p
  • :delmarks! deletes all marks for the current buffer
 :ma :mark :mark a-zA-Z

Mark current location within the web page.

 :marks :marks arg

Show all local marks for the current web page and all URL marks. If arg is specified then limit the list to those marks mentioned.