Skip to content

prmichaelsen/linenoteplus

 
 

Repository files navigation

Line Note Plus

Line Note Plus is a VSCode extension to add markdown notes to your code that are visible when hovering over the noted line. Based on Line Note.

basic-demo

VSCode Marketplace

Features

Invoke Add note at current position from the command palette or context menu. You can see the note you wrote as hover text.

Notes are saved by default in $PROJECT_ROOT/.vscode/.linenoteplus like .vscode/.linenoteplus/<short-uid>.md.

Overview

  • Edit/open or remove note via Cmd + Click
  • Markdown note previews on hover
  • Right-click to add note to line
  • Right-click to reveal notated line
  • Delete a note marker by manually deleting in text editor
  • Add a note marker by manually typing in text editor
  • Custom note names
  • Command to add note
  • Command to edit/open note
  • Command to remove note
  • Command to reveal notated line
  • Notes move with code changes
  • Notes can be moved between files
  • Notes are not affected by refactors
  • Add notes within your notes
  • Customize notes directory, note marker background color, and annoted line ruler color
  • Configure to delete orphaned notes on-save, on-inteveral, on-save-and-on-interval, or never

API

Commands

  • linenoteplus.addNote: Add note at current position (Annotate Line)
  • linenoteplus.openNote: Edit note at current position (Open Note)
  • linenoteplus.revealLine: Reveal line in notated file (Show Note Marker)
  • linenoteplus.removeNote: Remove note at current position (Delete Note)

Configuration

  • linenoteplus.cleanUpOrphanedNotesInterval: Interval at which to clean up unused notes in the background in ms. Only applies if cleanUpOrphanedNotes is set to on-interval or on-save-and-on-interval. Default: 60000 (60s). For performance, a larger value is recommended.
  • linenoteplus.cleanUpOrphanedNotes: Defines the cleanup behavior for orphaned notes. It can be set to on-save, on-interval, on-save-and-on-interval, or never. Default: on-save-and-on-internal. Note that when using on-save or on-save-and-on-interval, if you delete a note marker and save the file then your note file will also be deleted.
  • linenoteplus.includePaths: Specifies file pattern globs to scan for note markers. Directories that don't match these patterns will be ignored.
  • linenoteplus.gutterIconPath: File path of the icon to be displayed in gutter.
  • linenoteplus.lineColor: Sets the background color for inline note markers (Name, HEX, or RGB).
  • linenoteplus.rulerColor: Sets the ruler color for notated lines (Name, HEX, or RGB).
  • linenoteplus.showGutterIcon: Whether to display the gutter icon in the gutter for a noted line. Default: true.

Demos

Adding a note

add-note

Custom note title

custom-name

Notes move with code changes

moves-with-code

Notes can be moved across files

move-notes-across-files

Reveal notated line command

reveal-notated-file

Refactor does not affect notes

refactor-does-not-affect-notes

Acknowledgements

Line Note Plus is a fork of Line Note by tkrkt. This library's design was also informed by Marginalia by indiejames.

Contributing

PRs for bugfixes are welcome. I have no roadmap for new features, only improving stability.

Known Bugs

  • Gutter icon does not display.

VSCode Marketplace

About

Annotate lines of code with Markdown notes visible on hover.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 99.3%
  • JavaScript 0.7%