An extension for Visual Studio Code

Bookmark.

Lines worth noting. You've already lost your place twice today.

Install in VS CodeSee what you're missing
Free, no account, 34K+ installs on the Marketplace and Open VSX
parser.tsBookmark
⑂ main0Ln 1
Click the margin. Or press ⌘⌥K, then ⌘⌥L to jump.

Where
was I?

You know the line. You know it's in this file. Or the other one. Every minute you spend finding your place is a minute you didn't spend on the thing you were doing.

Hunting for your place
0:00.0
Scroll up. Scroll down. Search for a word that appears forty times. Squint.
Bookmark
One key.
You marked it on the way past. Now you're back on it, in whichever file it lives.
34K+installs across the Visual Studio Marketplace and Open VSX
3 keysto mark, to go forward, to go back. That's the whole manual.
0 accountsNothing to sign up for, nothing to sign in to, nothing to renew.

Lines move.
Bookmarks
keep up.

Add code above them. Reformat the whole file. Everything that makes a line number a bad place to keep a memory, and your stars are still on the right lines.

save.ts
Lines pushed down: 0. Bookmarks lost: 0.
How? That one's ours.

Say why.

A star tells you where. A note tells you why you cared. Put a cursor on every line that needs it and write it once.

load.ts

Three keys.

Learn them in the time it takes to read this. Go on, press them.

Toggle

Mark the line you're on, or unmark it. Several cursors, several lines, one press.

Next

Jump to the next one. Across files. At the end, it wraps around.

Previous

And back again.

Small things.
Big difference.

A few of the things you get. Not all of them.

The margin

A star in the gutter, right where your eyes already are. Click it to mark a line, click it again to let go.

Every file, one list

A sidebar of every file you've marked and every line in it. Click one and you land there.

The count

A running total in the status bar and on the sidebar icon, then it gets out of the way. You decide how long it lingers.

Search your marks

One menu of every bookmark. Filter by file, by line, or by your own note. Comment or remove right from the list.

Take them with you

Export to a JSON file. Hand it to a teammate, or import it on another machine.

Anywhere

Desktop, the browser, virtual workspaces, and editors that install from Open VSX.

Under the hood

Not in the readme

Quiet
by design.

One setting. A handful of commands. Everything else just works.

Commands

  • Mark or unmarkBookmark: Toggle
  • Add a noteBookmark: Comment
  • Search all of themBookmark: Menu
  • Save to JSONBookmark: Export
  • Load from JSONBookmark: Import

Sidebar

  • Mark the current lineAdd
  • Search everythingMenu
  • Save to JSONExport
  • Load from JSONImport
  • Start overRemove all

Setting

  • How long the count lingers, in secondstoast.seconds

Fair questions.

Is it really free?

Yes. Free on the Visual Studio Marketplace and on Open VSX. No account, no sign-in, no tier to upgrade to.

Will my bookmarks survive me editing the file?

They're built to. Add lines above, reformat, switch branches, and they keep their place. How is the one thing we're keeping to ourselves.

Where are my bookmarks kept?

In your editor's own storage for that workspace, on your machine. There's nothing to sync and nowhere for them to go.

Can I comment on several lines at once?

Yes. Put a cursor on each line, run Bookmark: Comment, and one note lands on all of them. It shows above the line, where you'll see it.

Can I share them with a teammate?

Run Bookmark: Export and you get a JSON file. Send it over. They open it in the editor and run Bookmark: Import.

Which editors does it run in?

Visual Studio Code 1.98 or later, VS Code for the Web, and editors that install extensions from Open VSX, such as VSCodium.

What are the keys on Windows and Linux?

CtrlAltK to toggle, L for next, J for previous. On a Mac, swap Ctrl for ⌘ and Alt for ⌥.

Mark it.
Or lose it.

Somewhere in your editor right now is a line you'll need again in an hour.

Install in VS CodeGet it on Open VSX
Free, no account, Visual Studio Marketplace, VS Code 1.98 or later