Emacs Docs

Appearance

Link interface for developers or advanced users ​

Format of Org link to note. The value is passed to format with ‘IDENTIFIER’ and ‘TITLE’ arguments, in this order. Also see denote-org-link-in-context-regexp.

Format of Markdown link to note. The ‘%N$s’ notation used in the default value is for format as the supplied arguments are ‘IDENTIFIER’ and ‘TITLE’, in this order. Also see denote-md-link-in-context-regexp.

Format of identifier-only link to note. The value is passed to format with ‘IDENTIFIER’ as its sole argument. Also see denote-id-only-link-in-context-regexp.

Regexp to match an Org link in its context. The format of such links is denote-org-link-format.

Regexp to match an Markdown link in its context. The format of such links is denote-md-link-format.

Regexp to match an identifier-only link in its context. The format of such links is denote-id-only-link-format.

Function denote-select-linked-file-prompt ​

Prompt for linked file among ‘FILES’.

Return list of links in current or optional ‘FILE’. With optional ‘FILES’ consider only those, otherwise use the return value of denote-directory-files. Also see denote-get-backlinks.

Return list of backlinks in current or optional ‘FILE’. Also see denote-get-links.

Return link description for ‘FILE’ with ‘FILE-TYPE’. For backward compatibility, ‘FILE-TYPE’ is an optional parameter. If it is nil, then compute ‘FILE-TYPE’ internally.

  • If the region is active, use it as the description.
  • If ‘FILE’ has a signature, then format the description as a sequence of the signature text and the title with two spaces between them.
  • If ‘FILE’ does not have a signature, then use its title as the description.
  • If none of the above works, return an empty string.

This function is useful as the value of the user option denote-link-description-format (which can optionally be bound to a function).