Bookmarks¶
Bookmarks let you flag individual lines while reviewing a comparison so you can return to them quickly without scrolling.
Toggling a Bookmark¶
Click the line number of any line to add a bookmark to it. An accent-coloured dot appears to the left of the line number to mark it. Click the line number again to remove the bookmark.
You can also use the keyboard:
| Action | Key |
|---|---|
| Toggle bookmark on the current or hovered line | Ctrl+B |
Bookmarked lines also show a narrow accent strip on the right edge of each minimap, giving you an at-a-glance map of where your bookmarks are across the whole file.
Tip
Bookmarks are tracked per side. You can bookmark a line on the left, the right, or both independently.
Viewing All Bookmarks¶
When at least one bookmark exists, a bookmark icon with a count appears in the stats bar. Click it to open the Bookmarks dialog, which lists all bookmarks for both sides in line-number order.
Click any entry in the dialog to scroll the comparison to that line.
Renaming a Bookmark¶
By default each bookmark is labelled with a snippet of the line content. To give it a more descriptive name, click the title field next to the entry in the Bookmarks dialog and type a new label.
Removing Bookmarks¶
| Action | How |
|---|---|
| Remove one bookmark | Click the trash icon next to its entry in the dialog |
| Remove all left-side bookmarks | Click Clear L in the dialog |
| Remove all right-side bookmarks | Click Clear R in the dialog |
| Remove all bookmarks on both sides | Click Clear All in the dialog |
When to Use Bookmarks¶
Bookmarks are useful when you need to keep track of several interesting locations across a long comparison - for example, a change that depends on context further down the file, or a line you want to revisit after reading more of the diff.
Note
Bookmarks are stored in memory only. They are not saved to disk and will be lost when you close the tab or load a different file into that side.