org-bookmark-heading

This library provides Emacs bookmark support for Org mode. You can bookmark headings in Org files and jump to them using standard Emacs bookmark commands.

It seems like this package should be named org-bookmark, but a package by that name already exists in org-mode/contrib which lets Org links point to Emacs bookmarks.

It also seems like this should be built-in to Org. Someday it may be upstreamed…

Installation

If you’ve installed from MELPA (or with a package system like Straight or Quelpa), you’re done. Then you can customize org-bookmark-jump-indirect if you like.

To install manually, put org-bookmark-heading.el in your load-path and require the feature in your init file:

(require 'org-bookmark-heading)

Usage

Use the standard Emacs bookmark commands, C-x r m, etc.

If you use Helm, you can jump to Org bookmarks in an indirect buffer by pressing <C-return> in the Helm buffer, or by choosing the action from the list.

You can also customize the variable org-bookmark-jump-indirect to make Org bookmarks always open in indirect buffers.

Changelog

1.4-pre

Changes

• Abbreviate filenames with abbreviate-file-name. (#9. Thanks to Akira Komamura.)
• When showing an Org subtree in an indirect buffer, reuse an existing indirect buffer that shows the same subtree, when possible (rather than duplicating indirect buffers if the same bookmark is opened multiple times in a session).

1.3.2

Compatibility

• Require Emacs 25.1 or later (this appears to have been necessary for a while, so making it official is belated but correct).
• Depend on compat package.

Fixes

• Call org-bookmark-heading-after-jump-hook every time (instead of only when using indirect buffers). (#30. Thanks to Tim Wichmann.)

1.3.1

Fixes

• Option org-bookmark-heading-make-ids when bookmarking an indirect buffer with option set to Make ID if missing and entry is within `org-directory'.

1.3

Additions

• Option org-bookmark-heading-after-jump-hook is called after jumping to a bookmark. It can be used to, e.g. cycle visibility.

Fixes

• Use file-truename when comparing filenames.
• Byte-compilation error on newer versions of Emacs. (Thanks to Akira Komamura and Renato Ferreira.)

1.2

Additions

• Option org-bookmark-heading-make-ids controls whether a new ID is created when none exists.

Changes

• Bookmark records always include the filename, outline path, and an existing ID property.
• When a bookmark is created in an indirect buffer, the restored bookmark will use an indirect buffer.
• Lexical binding is enabled.
• Library f is no longer used.
• Symbols are now properly prefixed with the package name, and obsolete aliases to the former names are defined.
• Various small improvements.

1.1

Additions

• Proper customization group, org-bookmark-heading.
• Customizeable filename function, org-bookmark-heading-filename-fn.

Changes

• Use org-link-display-format instead of custom function.
• By default, add parent directory to displayed filename.

1.0.0

Initial stable release.

Credits

• Thanks to Steve Purcell for his advice on several improvements.
• Thanks to Joshua Moller-Mara for his patch improving robustness.
• Thanks to Nicolas Goaziou for suggesting several improvements.

License

GPLv3